CodeArtifact 2018-09-22
- Client: Aws\CodeArtifact\CodeArtifactClient
- Service ID: codeartifact
- Version: 2018-09-22
This page describes the parameters and results for the operations of the CodeArtifact (2018-09-22), and shows how to use the Aws\CodeArtifact\CodeArtifactClient object to call the described operations. This documentation is specific to the 2018-09-22 API version of the service.
Operation Summary
Each of the following operations can be created from a client using
$client->getCommand('CommandName')
, where "CommandName" is the
name of one of the following operations. Note: a command is a value that
encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods
available on a client object: $client->commandName(/* parameters */)
.
You can send the command asynchronously (returning a promise) by appending the
word "Async" to the operation name: $client->commandNameAsync(/* parameters */)
.
- AssociateExternalConnection ( array $params = [] )
- Adds an existing external connection to a repository.
- CopyPackageVersions ( array $params = [] )
- Copies package versions from one repository to another repository in the same domain.
- CreateDomain ( array $params = [] )
- Creates a domain.
- CreatePackageGroup ( array $params = [] )
- Creates a package group.
- CreateRepository ( array $params = [] )
- Creates a repository.
- DeleteDomain ( array $params = [] )
- Deletes a domain.
- DeleteDomainPermissionsPolicy ( array $params = [] )
- Deletes the resource policy set on a domain.
- DeletePackage ( array $params = [] )
- Deletes a package and all associated package versions.
- DeletePackageGroup ( array $params = [] )
- Deletes a package group.
- DeletePackageVersions ( array $params = [] )
- Deletes one or more versions of a package.
- DeleteRepository ( array $params = [] )
- Deletes a repository.
- DeleteRepositoryPermissionsPolicy ( array $params = [] )
- Deletes the resource policy that is set on a repository.
- DescribeDomain ( array $params = [] )
- Returns a DomainDescription object that contains information about the requested domain.
- DescribePackage ( array $params = [] )
- Returns a PackageDescription object that contains information about the requested package.
- DescribePackageGroup ( array $params = [] )
- Returns a PackageGroupDescription object that contains information about the requested package group.
- DescribePackageVersion ( array $params = [] )
- Returns a PackageVersionDescription object that contains information about the requested package version.
- DescribeRepository ( array $params = [] )
- Returns a RepositoryDescription object that contains detailed information about the requested repository.
- DisassociateExternalConnection ( array $params = [] )
- Removes an existing external connection from a repository.
- DisposePackageVersions ( array $params = [] )
- Deletes the assets in package versions and sets the package versions' status to Disposed.
- GetAssociatedPackageGroup ( array $params = [] )
- Returns the most closely associated package group to the specified package.
- GetAuthorizationToken ( array $params = [] )
- Generates a temporary authorization token for accessing repositories in the domain.
- GetDomainPermissionsPolicy ( array $params = [] )
- Returns the resource policy attached to the specified domain.
- GetPackageVersionAsset ( array $params = [] )
- Returns an asset (or file) that is in a package.
- GetPackageVersionReadme ( array $params = [] )
- Gets the readme file or descriptive text for a package version.
- GetRepositoryEndpoint ( array $params = [] )
- Returns the endpoint of a repository for a specific package format.
- GetRepositoryPermissionsPolicy ( array $params = [] )
- Returns the resource policy that is set on a repository.
- ListAllowedRepositoriesForGroup ( array $params = [] )
- Lists the repositories in the added repositories list of the specified restriction type for a package group.
- ListAssociatedPackages ( array $params = [] )
- Returns a list of packages associated with the requested package group.
- ListDomains ( array $params = [] )
- Returns a list of DomainSummary objects for all domains owned by the Amazon Web Services account that makes this call.
- ListPackageGroups ( array $params = [] )
- Returns a list of package groups in the requested domain.
- ListPackageVersionAssets ( array $params = [] )
- Returns a list of AssetSummary objects for assets in a package version.
- ListPackageVersionDependencies ( array $params = [] )
- Returns the direct dependencies for a package version.
- ListPackageVersions ( array $params = [] )
- Returns a list of PackageVersionSummary objects for package versions in a repository that match the request parameters.
- ListPackages ( array $params = [] )
- Returns a list of PackageSummary objects for packages in a repository that match the request parameters.
- ListRepositories ( array $params = [] )
- Returns a list of RepositorySummary objects.
- ListRepositoriesInDomain ( array $params = [] )
- Returns a list of RepositorySummary objects.
- ListSubPackageGroups ( array $params = [] )
- Returns a list of direct children of the specified package group.
- ListTagsForResource ( array $params = [] )
- Gets information about Amazon Web Services tags for a specified Amazon Resource Name (ARN) in CodeArtifact.
- PublishPackageVersion ( array $params = [] )
- Creates a new package version containing one or more assets (or files).
- PutDomainPermissionsPolicy ( array $params = [] )
- Sets a resource policy on a domain that specifies permissions to access it.
- PutPackageOriginConfiguration ( array $params = [] )
- Sets the package origin configuration for a package.
- PutRepositoryPermissionsPolicy ( array $params = [] )
- Sets the resource policy on a repository that specifies permissions to access it.
- TagResource ( array $params = [] )
- Adds or updates tags for a resource in CodeArtifact.
- UntagResource ( array $params = [] )
- Removes tags from a resource in CodeArtifact.
- UpdatePackageGroup ( array $params = [] )
- Updates a package group.
- UpdatePackageGroupOriginConfiguration ( array $params = [] )
- Updates the package origin configuration for a package group.
- UpdatePackageVersionsStatus ( array $params = [] )
- Updates the status of one or more versions of a package.
- UpdateRepository ( array $params = [] )
- Update the properties of a repository.
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
- ListAllowedRepositoriesForGroup
- ListAssociatedPackages
- ListDomains
- ListPackageGroups
- ListPackageVersionAssets
- ListPackageVersions
- ListPackages
- ListRepositories
- ListRepositoriesInDomain
- ListSubPackageGroups
Operations
AssociateExternalConnection
$result = $client->associateExternalConnection
([/* ... */]); $promise = $client->associateExternalConnectionAsync
([/* ... */]);
Adds an existing external connection to a repository. One external connection is allowed per repository.
A repository can have one or more upstream repositories, or an external connection.
Parameter Syntax
$result = $client->associateExternalConnection([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'externalConnection' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- externalConnection
-
- Required: Yes
- Type: string
The name of the external connection to add to the repository. The following values are supported:
-
public:npmjs
- for the npm public repository. -
public:nuget-org
- for the NuGet Gallery. -
public:pypi
- for the Python Package Index. -
public:maven-central
- for Maven Central. -
public:maven-googleandroid
- for the Google Android repository. -
public:maven-gradleplugins
- for the Gradle plugins repository. -
public:maven-commonsware
- for the CommonsWare Android repository. -
public:maven-clojars
- for the Clojars repository. -
public:ruby-gems-org
- for RubyGems.org. -
public:crates-io
- for Crates.io.
- repository
-
- Required: Yes
- Type: string
The name of the repository to which the external connection is added.
Result Syntax
[ 'repository' => [ 'administratorAccount' => '<string>', 'arn' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'externalConnections' => [ [ 'externalConnectionName' => '<string>', 'packageFormat' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'status' => 'Available', ], // ... ], 'name' => '<string>', 'upstreams' => [ [ 'repositoryName' => '<string>', ], // ... ], ], ]
Result Details
Members
- repository
-
- Type: RepositoryDescription structure
Information about the connected repository after processing the request.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
CopyPackageVersions
$result = $client->copyPackageVersions
([/* ... */]); $promise = $client->copyPackageVersionsAsync
([/* ... */]);
Copies package versions from one repository to another repository in the same domain.
You must specify versions
or versionRevisions
. You cannot specify both.
Parameter Syntax
$result = $client->copyPackageVersions([ 'allowOverwrite' => true || false, 'destinationRepository' => '<string>', // REQUIRED 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'includeFromUpstream' => true || false, 'namespace' => '<string>', 'package' => '<string>', // REQUIRED 'sourceRepository' => '<string>', // REQUIRED 'versionRevisions' => ['<string>', ...], 'versions' => ['<string>', ...], ]);
Parameter Details
Members
- allowOverwrite
-
- Type: boolean
Set to true to overwrite a package version that already exists in the destination repository. If set to false and the package version already exists in the destination repository, the package version is returned in the
failedVersions
field of the response with anALREADY_EXISTS
error code. - destinationRepository
-
- Required: Yes
- Type: string
The name of the repository into which package versions are copied.
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the source and destination repositories.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- format
-
- Required: Yes
- Type: string
The format of the package versions to be copied.
- includeFromUpstream
-
- Type: boolean
Set to true to copy packages from repositories that are upstream from the source repository to the destination repository. The default setting is false. For more information, see Working with upstream repositories.
- namespace
-
- Type: string
The namespace of the package versions to be copied. The package component that specifies its namespace depends on its type. For example:
The namespace is required when copying package versions of the following formats:
-
Maven
-
Swift
-
generic
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Required: Yes
- Type: string
The name of the package that contains the versions to be copied.
- sourceRepository
-
- Required: Yes
- Type: string
The name of the repository that contains the package versions to be copied.
- versionRevisions
-
- Type: Associative array of custom strings keys (PackageVersion) to strings
A list of key-value pairs. The keys are package versions and the values are package version revisions. A
CopyPackageVersion
operation succeeds if the specified versions in the source repository match the specified package version revision.You must specify
versions
orversionRevisions
. You cannot specify both. - versions
-
- Type: Array of strings
The versions of the package to be copied.
You must specify
versions
orversionRevisions
. You cannot specify both.
Result Syntax
[ 'failedVersions' => [ '<PackageVersion>' => [ 'errorCode' => 'ALREADY_EXISTS|MISMATCHED_REVISION|MISMATCHED_STATUS|NOT_ALLOWED|NOT_FOUND|SKIPPED', 'errorMessage' => '<string>', ], // ... ], 'successfulVersions' => [ '<PackageVersion>' => [ 'revision' => '<string>', 'status' => 'Published|Unfinished|Unlisted|Archived|Disposed|Deleted', ], // ... ], ]
Result Details
Members
- failedVersions
-
- Type: Associative array of custom strings keys (PackageVersion) to PackageVersionError structures
A map of package versions that failed to copy and their error codes. The possible error codes are in the
PackageVersionError
data type. They are:-
ALREADY_EXISTS
-
MISMATCHED_REVISION
-
MISMATCHED_STATUS
-
NOT_ALLOWED
-
NOT_FOUND
-
SKIPPED
- successfulVersions
-
- Type: Associative array of custom strings keys (PackageVersion) to SuccessfulPackageVersionInfo structures
A list of the package versions that were successfully copied to your repository.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
CreateDomain
$result = $client->createDomain
([/* ... */]); $promise = $client->createDomainAsync
([/* ... */]);
Creates a domain. CodeArtifact domains make it easier to manage multiple repositories across an organization. You can use a domain to apply permissions across many repositories owned by different Amazon Web Services accounts. An asset is stored only once in a domain, even if it's in multiple repositories.
Although you can have multiple domains, we recommend a single production domain that contains all published artifacts so that your development teams can find and share packages. You can use a second pre-production domain to test changes to the production domain configuration.
Parameter Syntax
$result = $client->createDomain([ 'domain' => '<string>', // REQUIRED 'encryptionKey' => '<string>', 'tags' => [ [ 'key' => '<string>', // REQUIRED 'value' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain to create. All domain names in an Amazon Web Services Region that are in the same Amazon Web Services account must be unique. The domain name is used as the prefix in DNS hostnames. Do not use sensitive information in a domain name because it is publicly discoverable.
- encryptionKey
-
- Type: string
The encryption key for the domain. This is used to encrypt content stored in a domain. An encryption key can be a key ID, a key Amazon Resource Name (ARN), a key alias, or a key alias ARN. To specify an
encryptionKey
, your IAM role must havekms:DescribeKey
andkms:CreateGrant
permissions on the encryption key that is used. For more information, see DescribeKey in the Key Management Service API Reference and Key Management Service API Permissions Reference in the Key Management Service Developer Guide.CodeArtifact supports only symmetric CMKs. Do not associate an asymmetric CMK with your domain. For more information, see Using symmetric and asymmetric keys in the Key Management Service Developer Guide.
- tags
-
- Type: Array of Tag structures
One or more tag key-value pairs for the domain.
Result Syntax
[ 'domain' => [ 'arn' => '<string>', 'assetSizeBytes' => <integer>, 'createdTime' => <DateTime>, 'encryptionKey' => '<string>', 'name' => '<string>', 'owner' => '<string>', 'repositoryCount' => <integer>, 's3BucketArn' => '<string>', 'status' => 'Active|Deleted', ], ]
Result Details
Members
- domain
-
- Type: DomainDescription structure
Contains information about the created domain after processing the request.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
CreatePackageGroup
$result = $client->createPackageGroup
([/* ... */]); $promise = $client->createPackageGroupAsync
([/* ... */]);
Creates a package group. For more information about creating package groups, including example CLI commands, see Create a package group in the CodeArtifact User Guide.
Parameter Syntax
$result = $client->createPackageGroup([ 'contactInfo' => '<string>', 'description' => '<string>', 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'packageGroup' => '<string>', // REQUIRED 'tags' => [ [ 'key' => '<string>', // REQUIRED 'value' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- contactInfo
-
- Type: string
The contact information for the created package group.
- description
-
- Type: string
A description of the package group.
- domain
-
- Required: Yes
- Type: string
The name of the domain in which you want to create a package group.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- packageGroup
-
- Required: Yes
- Type: string
The pattern of the package group to create. The pattern is also the identifier of the package group.
- tags
-
- Type: Array of Tag structures
One or more tag key-value pairs for the package group.
Result Syntax
[ 'packageGroup' => [ 'arn' => '<string>', 'contactInfo' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'originConfiguration' => [ 'restrictions' => [ '<PackageGroupOriginRestrictionType>' => [ 'effectiveMode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'inheritedFrom' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'mode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'repositoriesCount' => <integer>, ], // ... ], ], 'parent' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'pattern' => '<string>', ], ]
Result Details
Members
- packageGroup
-
- Type: PackageGroupDescription structure
Information about the created package group after processing the request.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
CreateRepository
$result = $client->createRepository
([/* ... */]); $promise = $client->createRepositoryAsync
([/* ... */]);
Creates a repository.
Parameter Syntax
$result = $client->createRepository([ 'description' => '<string>', 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'repository' => '<string>', // REQUIRED 'tags' => [ [ 'key' => '<string>', // REQUIRED 'value' => '<string>', // REQUIRED ], // ... ], 'upstreams' => [ [ 'repositoryName' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- description
-
- Type: string
A description of the created repository.
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the created repository.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- repository
-
- Required: Yes
- Type: string
The name of the repository to create.
- tags
-
- Type: Array of Tag structures
One or more tag key-value pairs for the repository.
- upstreams
-
- Type: Array of UpstreamRepository structures
A list of upstream repositories to associate with the repository. The order of the upstream repositories in the list determines their priority order when CodeArtifact looks for a requested package version. For more information, see Working with upstream repositories.
Result Syntax
[ 'repository' => [ 'administratorAccount' => '<string>', 'arn' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'externalConnections' => [ [ 'externalConnectionName' => '<string>', 'packageFormat' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'status' => 'Available', ], // ... ], 'name' => '<string>', 'upstreams' => [ [ 'repositoryName' => '<string>', ], // ... ], ], ]
Result Details
Members
- repository
-
- Type: RepositoryDescription structure
Information about the created repository after processing the request.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DeleteDomain
$result = $client->deleteDomain
([/* ... */]); $promise = $client->deleteDomainAsync
([/* ... */]);
Deletes a domain. You cannot delete a domain that contains repositories. If you want to delete a domain with repositories, first delete its repositories.
Parameter Syntax
$result = $client->deleteDomain([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain to delete.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
Result Syntax
[ 'domain' => [ 'arn' => '<string>', 'assetSizeBytes' => <integer>, 'createdTime' => <DateTime>, 'encryptionKey' => '<string>', 'name' => '<string>', 'owner' => '<string>', 'repositoryCount' => <integer>, 's3BucketArn' => '<string>', 'status' => 'Active|Deleted', ], ]
Result Details
Members
- domain
-
- Type: DomainDescription structure
Contains information about the deleted domain after processing the request.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DeleteDomainPermissionsPolicy
$result = $client->deleteDomainPermissionsPolicy
([/* ... */]); $promise = $client->deleteDomainPermissionsPolicyAsync
([/* ... */]);
Deletes the resource policy set on a domain.
Parameter Syntax
$result = $client->deleteDomainPermissionsPolicy([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'policyRevision' => '<string>', ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain associated with the resource policy to be deleted.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- policyRevision
-
- Type: string
The current revision of the resource policy to be deleted. This revision is used for optimistic locking, which prevents others from overwriting your changes to the domain's resource policy.
Result Syntax
[ 'policy' => [ 'document' => '<string>', 'resourceArn' => '<string>', 'revision' => '<string>', ], ]
Result Details
Members
- policy
-
- Type: ResourcePolicy structure
Information about the deleted resource policy after processing the request.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DeletePackage
$result = $client->deletePackage
([/* ... */]); $promise = $client->deletePackageAsync
([/* ... */]);
Deletes a package and all associated package versions. A deleted package cannot be restored. To delete one or more package versions, use the DeletePackageVersions API.
Parameter Syntax
$result = $client->deletePackage([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'namespace' => '<string>', 'package' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the package to delete.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- format
-
- Required: Yes
- Type: string
The format of the requested package to delete.
- namespace
-
- Type: string
The namespace of the package to delete. The package component that specifies its namespace depends on its type. For example:
The namespace is required when deleting packages of the following formats:
-
Maven
-
Swift
-
generic
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Required: Yes
- Type: string
The name of the package to delete.
- repository
-
- Required: Yes
- Type: string
The name of the repository that contains the package to delete.
Result Syntax
[ 'deletedPackage' => [ 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'namespace' => '<string>', 'originConfiguration' => [ 'restrictions' => [ 'publish' => 'ALLOW|BLOCK', 'upstream' => 'ALLOW|BLOCK', ], ], 'package' => '<string>', ], ]
Result Details
Members
- deletedPackage
-
- Type: PackageSummary structure
Details about a package, including its format, namespace, and name.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DeletePackageGroup
$result = $client->deletePackageGroup
([/* ... */]); $promise = $client->deletePackageGroupAsync
([/* ... */]);
Deletes a package group. Deleting a package group does not delete packages or package versions associated with the package group. When a package group is deleted, the direct child package groups will become children of the package group's direct parent package group. Therefore, if any of the child groups are inheriting any settings from the parent, those settings could change.
Parameter Syntax
$result = $client->deletePackageGroup([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'packageGroup' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The domain that contains the package group to be deleted.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- packageGroup
-
- Required: Yes
- Type: string
The pattern of the package group to be deleted.
Result Syntax
[ 'packageGroup' => [ 'arn' => '<string>', 'contactInfo' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'originConfiguration' => [ 'restrictions' => [ '<PackageGroupOriginRestrictionType>' => [ 'effectiveMode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'inheritedFrom' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'mode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'repositoriesCount' => <integer>, ], // ... ], ], 'parent' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'pattern' => '<string>', ], ]
Result Details
Members
- packageGroup
-
- Type: PackageGroupDescription structure
Information about the deleted package group after processing the request.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DeletePackageVersions
$result = $client->deletePackageVersions
([/* ... */]); $promise = $client->deletePackageVersionsAsync
([/* ... */]);
Deletes one or more versions of a package. A deleted package version cannot be restored in your repository. If you want to remove a package version from your repository and be able to restore it later, set its status to Archived
. Archived packages cannot be downloaded from a repository and don't show up with list package APIs (for example, ListPackageVersions), but you can restore them using UpdatePackageVersionsStatus.
Parameter Syntax
$result = $client->deletePackageVersions([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'expectedStatus' => 'Published|Unfinished|Unlisted|Archived|Disposed|Deleted', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'namespace' => '<string>', 'package' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED 'versions' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the package to delete.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- expectedStatus
-
- Type: string
The expected status of the package version to delete.
- format
-
- Required: Yes
- Type: string
The format of the package versions to delete.
- namespace
-
- Type: string
The namespace of the package versions to be deleted. The package component that specifies its namespace depends on its type. For example:
The namespace is required when deleting package versions of the following formats:
-
Maven
-
Swift
-
generic
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Required: Yes
- Type: string
The name of the package with the versions to delete.
- repository
-
- Required: Yes
- Type: string
The name of the repository that contains the package versions to delete.
- versions
-
- Required: Yes
- Type: Array of strings
An array of strings that specify the versions of the package to delete.
Result Syntax
[ 'failedVersions' => [ '<PackageVersion>' => [ 'errorCode' => 'ALREADY_EXISTS|MISMATCHED_REVISION|MISMATCHED_STATUS|NOT_ALLOWED|NOT_FOUND|SKIPPED', 'errorMessage' => '<string>', ], // ... ], 'successfulVersions' => [ '<PackageVersion>' => [ 'revision' => '<string>', 'status' => 'Published|Unfinished|Unlisted|Archived|Disposed|Deleted', ], // ... ], ]
Result Details
Members
- failedVersions
-
- Type: Associative array of custom strings keys (PackageVersion) to PackageVersionError structures
A
PackageVersionError
object that contains a map of errors codes for the deleted package that failed. The possible error codes are:-
ALREADY_EXISTS
-
MISMATCHED_REVISION
-
MISMATCHED_STATUS
-
NOT_ALLOWED
-
NOT_FOUND
-
SKIPPED
- successfulVersions
-
- Type: Associative array of custom strings keys (PackageVersion) to SuccessfulPackageVersionInfo structures
A list of the package versions that were successfully deleted. The status of every successful version will be
Deleted
.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DeleteRepository
$result = $client->deleteRepository
([/* ... */]); $promise = $client->deleteRepositoryAsync
([/* ... */]);
Deletes a repository.
Parameter Syntax
$result = $client->deleteRepository([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository to delete.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- repository
-
- Required: Yes
- Type: string
The name of the repository to delete.
Result Syntax
[ 'repository' => [ 'administratorAccount' => '<string>', 'arn' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'externalConnections' => [ [ 'externalConnectionName' => '<string>', 'packageFormat' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'status' => 'Available', ], // ... ], 'name' => '<string>', 'upstreams' => [ [ 'repositoryName' => '<string>', ], // ... ], ], ]
Result Details
Members
- repository
-
- Type: RepositoryDescription structure
Information about the deleted repository after processing the request.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DeleteRepositoryPermissionsPolicy
$result = $client->deleteRepositoryPermissionsPolicy
([/* ... */]); $promise = $client->deleteRepositoryPermissionsPolicyAsync
([/* ... */]);
Deletes the resource policy that is set on a repository. After a resource policy is deleted, the permissions allowed and denied by the deleted policy are removed. The effect of deleting a resource policy might not be immediate.
Use DeleteRepositoryPermissionsPolicy
with caution. After a policy is deleted, Amazon Web Services users, roles, and accounts lose permissions to perform the repository actions granted by the deleted policy.
Parameter Syntax
$result = $client->deleteRepositoryPermissionsPolicy([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'policyRevision' => '<string>', 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository associated with the resource policy to be deleted.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- policyRevision
-
- Type: string
The revision of the repository's resource policy to be deleted. This revision is used for optimistic locking, which prevents others from accidentally overwriting your changes to the repository's resource policy.
- repository
-
- Required: Yes
- Type: string
The name of the repository that is associated with the resource policy to be deleted
Result Syntax
[ 'policy' => [ 'document' => '<string>', 'resourceArn' => '<string>', 'revision' => '<string>', ], ]
Result Details
Members
- policy
-
- Type: ResourcePolicy structure
Information about the deleted policy after processing the request.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DescribeDomain
$result = $client->describeDomain
([/* ... */]); $promise = $client->describeDomainAsync
([/* ... */]);
Returns a DomainDescription object that contains information about the requested domain.
Parameter Syntax
$result = $client->describeDomain([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
A string that specifies the name of the requested domain.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
Result Syntax
[ 'domain' => [ 'arn' => '<string>', 'assetSizeBytes' => <integer>, 'createdTime' => <DateTime>, 'encryptionKey' => '<string>', 'name' => '<string>', 'owner' => '<string>', 'repositoryCount' => <integer>, 's3BucketArn' => '<string>', 'status' => 'Active|Deleted', ], ]
Result Details
Members
- domain
-
- Type: DomainDescription structure
Information about a domain. A domain is a container for repositories. When you create a domain, it is empty until you add one or more repositories.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DescribePackage
$result = $client->describePackage
([/* ... */]); $promise = $client->describePackageAsync
([/* ... */]);
Returns a PackageDescription object that contains information about the requested package.
Parameter Syntax
$result = $client->describePackage([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'namespace' => '<string>', 'package' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository that contains the package.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- format
-
- Required: Yes
- Type: string
A format that specifies the type of the requested package.
- namespace
-
- Type: string
The namespace of the requested package. The package component that specifies its namespace depends on its type. For example:
The namespace is required when requesting packages of the following formats:
-
Maven
-
Swift
-
generic
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Required: Yes
- Type: string
The name of the requested package.
- repository
-
- Required: Yes
- Type: string
The name of the repository that contains the requested package.
Result Syntax
[ 'package' => [ 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'name' => '<string>', 'namespace' => '<string>', 'originConfiguration' => [ 'restrictions' => [ 'publish' => 'ALLOW|BLOCK', 'upstream' => 'ALLOW|BLOCK', ], ], ], ]
Result Details
Members
- package
-
- Required: Yes
- Type: PackageDescription structure
A PackageDescription object that contains information about the requested package.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DescribePackageGroup
$result = $client->describePackageGroup
([/* ... */]); $promise = $client->describePackageGroupAsync
([/* ... */]);
Returns a PackageGroupDescription object that contains information about the requested package group.
Parameter Syntax
$result = $client->describePackageGroup([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'packageGroup' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the package group.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- packageGroup
-
- Required: Yes
- Type: string
The pattern of the requested package group.
Result Syntax
[ 'packageGroup' => [ 'arn' => '<string>', 'contactInfo' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'originConfiguration' => [ 'restrictions' => [ '<PackageGroupOriginRestrictionType>' => [ 'effectiveMode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'inheritedFrom' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'mode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'repositoriesCount' => <integer>, ], // ... ], ], 'parent' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'pattern' => '<string>', ], ]
Result Details
Members
- packageGroup
-
- Type: PackageGroupDescription structure
A PackageGroupDescription object that contains information about the requested package group.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
DescribePackageVersion
$result = $client->describePackageVersion
([/* ... */]); $promise = $client->describePackageVersionAsync
([/* ... */]);
Returns a PackageVersionDescription object that contains information about the requested package version.
Parameter Syntax
$result = $client->describePackageVersion([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'namespace' => '<string>', 'package' => '<string>', // REQUIRED 'packageVersion' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository that contains the package version.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- format
-
- Required: Yes
- Type: string
A format that specifies the type of the requested package version.
- namespace
-
- Type: string
The namespace of the requested package version. The package component that specifies its namespace depends on its type. For example:
The namespace is required when requesting package versions of the following formats:
-
Maven
-
Swift
-
generic
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Required: Yes
- Type: string
The name of the requested package version.
- packageVersion
-
- Required: Yes
- Type: string
A string that contains the package version (for example,
3.5.2
). - repository
-
- Required: Yes
- Type: string
The name of the repository that contains the package version.
Result Syntax
[ 'packageVersion' => [ 'displayName' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'homePage' => '<string>', 'licenses' => [ [ 'name' => '<string>', 'url' => '<string>', ], // ... ], 'namespace' => '<string>', 'origin' => [ 'domainEntryPoint' => [ 'externalConnectionName' => '<string>', 'repositoryName' => '<string>', ], 'originType' => 'INTERNAL|EXTERNAL|UNKNOWN', ], 'packageName' => '<string>', 'publishedTime' => <DateTime>, 'revision' => '<string>', 'sourceCodeRepository' => '<string>', 'status' => 'Published|Unfinished|Unlisted|Archived|Disposed|Deleted', 'summary' => '<string>', 'version' => '<string>', ], ]
Result Details
Members
- packageVersion
-
- Required: Yes
- Type: PackageVersionDescription structure
A PackageVersionDescription object that contains information about the requested package version.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DescribeRepository
$result = $client->describeRepository
([/* ... */]); $promise = $client->describeRepositoryAsync
([/* ... */]);
Returns a RepositoryDescription
object that contains detailed information about the requested repository.
Parameter Syntax
$result = $client->describeRepository([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository to describe.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- repository
-
- Required: Yes
- Type: string
A string that specifies the name of the requested repository.
Result Syntax
[ 'repository' => [ 'administratorAccount' => '<string>', 'arn' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'externalConnections' => [ [ 'externalConnectionName' => '<string>', 'packageFormat' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'status' => 'Available', ], // ... ], 'name' => '<string>', 'upstreams' => [ [ 'repositoryName' => '<string>', ], // ... ], ], ]
Result Details
Members
- repository
-
- Type: RepositoryDescription structure
A
RepositoryDescription
object that contains the requested repository information.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DisassociateExternalConnection
$result = $client->disassociateExternalConnection
([/* ... */]); $promise = $client->disassociateExternalConnectionAsync
([/* ... */]);
Removes an existing external connection from a repository.
Parameter Syntax
$result = $client->disassociateExternalConnection([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'externalConnection' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository from which to remove the external repository.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- externalConnection
-
- Required: Yes
- Type: string
The name of the external connection to be removed from the repository.
- repository
-
- Required: Yes
- Type: string
The name of the repository from which the external connection will be removed.
Result Syntax
[ 'repository' => [ 'administratorAccount' => '<string>', 'arn' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'externalConnections' => [ [ 'externalConnectionName' => '<string>', 'packageFormat' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'status' => 'Available', ], // ... ], 'name' => '<string>', 'upstreams' => [ [ 'repositoryName' => '<string>', ], // ... ], ], ]
Result Details
Members
- repository
-
- Type: RepositoryDescription structure
The repository associated with the removed external connection.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
DisposePackageVersions
$result = $client->disposePackageVersions
([/* ... */]); $promise = $client->disposePackageVersionsAsync
([/* ... */]);
Deletes the assets in package versions and sets the package versions' status to Disposed
. A disposed package version cannot be restored in your repository because its assets are deleted.
To view all disposed package versions in a repository, use ListPackageVersions and set the status parameter to Disposed
.
To view information about a disposed package version, use DescribePackageVersion.
Parameter Syntax
$result = $client->disposePackageVersions([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'expectedStatus' => 'Published|Unfinished|Unlisted|Archived|Disposed|Deleted', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'namespace' => '<string>', 'package' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED 'versionRevisions' => ['<string>', ...], 'versions' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository you want to dispose.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- expectedStatus
-
- Type: string
The expected status of the package version to dispose.
- format
-
- Required: Yes
- Type: string
A format that specifies the type of package versions you want to dispose.
- namespace
-
- Type: string
The namespace of the package versions to be disposed. The package component that specifies its namespace depends on its type. For example:
The namespace is required when disposing package versions of the following formats:
-
Maven
-
Swift
-
generic
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Required: Yes
- Type: string
The name of the package with the versions you want to dispose.
- repository
-
- Required: Yes
- Type: string
The name of the repository that contains the package versions you want to dispose.
- versionRevisions
-
- Type: Associative array of custom strings keys (PackageVersion) to strings
The revisions of the package versions you want to dispose.
- versions
-
- Required: Yes
- Type: Array of strings
The versions of the package you want to dispose.
Result Syntax
[ 'failedVersions' => [ '<PackageVersion>' => [ 'errorCode' => 'ALREADY_EXISTS|MISMATCHED_REVISION|MISMATCHED_STATUS|NOT_ALLOWED|NOT_FOUND|SKIPPED', 'errorMessage' => '<string>', ], // ... ], 'successfulVersions' => [ '<PackageVersion>' => [ 'revision' => '<string>', 'status' => 'Published|Unfinished|Unlisted|Archived|Disposed|Deleted', ], // ... ], ]
Result Details
Members
- failedVersions
-
- Type: Associative array of custom strings keys (PackageVersion) to PackageVersionError structures
A
PackageVersionError
object that contains a map of errors codes for the disposed package versions that failed. The possible error codes are:-
ALREADY_EXISTS
-
MISMATCHED_REVISION
-
MISMATCHED_STATUS
-
NOT_ALLOWED
-
NOT_FOUND
-
SKIPPED
- successfulVersions
-
- Type: Associative array of custom strings keys (PackageVersion) to SuccessfulPackageVersionInfo structures
A list of the package versions that were successfully disposed.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
GetAssociatedPackageGroup
$result = $client->getAssociatedPackageGroup
([/* ... */]); $promise = $client->getAssociatedPackageGroupAsync
([/* ... */]);
Returns the most closely associated package group to the specified package. This API does not require that the package exist in any repository in the domain. As such, GetAssociatedPackageGroup
can be used to see which package group's origin configuration applies to a package before that package is in a repository. This can be helpful to check if public packages are blocked without ingesting them.
For information package group association and matching, see Package group definition syntax and matching behavior in the CodeArtifact User Guide.
Parameter Syntax
$result = $client->getAssociatedPackageGroup([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'namespace' => '<string>', 'package' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the package from which to get the associated package group.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- format
-
- Required: Yes
- Type: string
The format of the package from which to get the associated package group.
- namespace
-
- Type: string
The namespace of the package from which to get the associated package group. The package component that specifies its namespace depends on its type. For example:
The namespace is required when getting associated package groups from packages of the following formats:
-
Maven
-
Swift
-
generic
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Required: Yes
- Type: string
The package from which to get the associated package group.
Result Syntax
[ 'associationType' => 'STRONG|WEAK', 'packageGroup' => [ 'arn' => '<string>', 'contactInfo' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'originConfiguration' => [ 'restrictions' => [ '<PackageGroupOriginRestrictionType>' => [ 'effectiveMode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'inheritedFrom' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'mode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'repositoriesCount' => <integer>, ], // ... ], ], 'parent' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'pattern' => '<string>', ], ]
Result Details
Members
- associationType
-
- Type: string
Describes the strength of the association between the package and package group. A strong match is also known as an exact match, and a weak match is known as a relative match.
- packageGroup
-
- Type: PackageGroupDescription structure
The package group that is associated with the requested package.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
GetAuthorizationToken
$result = $client->getAuthorizationToken
([/* ... */]); $promise = $client->getAuthorizationTokenAsync
([/* ... */]);
Generates a temporary authorization token for accessing repositories in the domain. This API requires the codeartifact:GetAuthorizationToken
and sts:GetServiceBearerToken
permissions. For more information about authorization tokens, see CodeArtifact authentication and tokens.
CodeArtifact authorization tokens are valid for a period of 12 hours when created with the login
command. You can call login
periodically to refresh the token. When you create an authorization token with the GetAuthorizationToken
API, you can set a custom authorization period, up to a maximum of 12 hours, with the durationSeconds
parameter.
The authorization period begins after login
or GetAuthorizationToken
is called. If login
or GetAuthorizationToken
is called while assuming a role, the token lifetime is independent of the maximum session duration of the role. For example, if you call sts assume-role
and specify a session duration of 15 minutes, then generate a CodeArtifact authorization token, the token will be valid for the full authorization period even though this is longer than the 15-minute session duration.
See Using IAM Roles for more information on controlling session duration.
Parameter Syntax
$result = $client->getAuthorizationToken([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'durationSeconds' => <integer>, ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that is in scope for the generated authorization token.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- durationSeconds
-
- Type: long (int|float)
The time, in seconds, that the generated authorization token is valid. Valid values are
0
and any number between900
(15 minutes) and43200
(12 hours). A value of0
will set the expiration of the authorization token to the same expiration of the user's role's temporary credentials.
Result Syntax
[ 'authorizationToken' => '<string>', 'expiration' => <DateTime>, ]
Result Details
Members
- authorizationToken
-
- Type: string
The returned authentication token.
- expiration
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp that specifies the date and time the authorization token expires.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
GetDomainPermissionsPolicy
$result = $client->getDomainPermissionsPolicy
([/* ... */]); $promise = $client->getDomainPermissionsPolicyAsync
([/* ... */]);
Returns the resource policy attached to the specified domain.
The policy is a resource-based policy, not an identity-based policy. For more information, see Identity-based policies and resource-based policies in the IAM User Guide.
Parameter Syntax
$result = $client->getDomainPermissionsPolicy([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain to which the resource policy is attached.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
Result Syntax
[ 'policy' => [ 'document' => '<string>', 'resourceArn' => '<string>', 'revision' => '<string>', ], ]
Result Details
Members
- policy
-
- Type: ResourcePolicy structure
The returned resource policy.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
GetPackageVersionAsset
$result = $client->getPackageVersionAsset
([/* ... */]); $promise = $client->getPackageVersionAssetAsync
([/* ... */]);
Returns an asset (or file) that is in a package. For example, for a Maven package version, use GetPackageVersionAsset
to download a JAR
file, a POM
file, or any other assets in the package version.
Parameter Syntax
$result = $client->getPackageVersionAsset([ 'asset' => '<string>', // REQUIRED 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'namespace' => '<string>', 'package' => '<string>', // REQUIRED 'packageVersion' => '<string>', // REQUIRED 'packageVersionRevision' => '<string>', 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- asset
-
- Required: Yes
- Type: string
The name of the requested asset.
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository that contains the package version with the requested asset.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- format
-
- Required: Yes
- Type: string
A format that specifies the type of the package version with the requested asset file.
- namespace
-
- Type: string
The namespace of the package version with the requested asset file. The package component that specifies its namespace depends on its type. For example:
The namespace is required when requesting assets from package versions of the following formats:
-
Maven
-
Swift
-
generic
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Required: Yes
- Type: string
The name of the package that contains the requested asset.
- packageVersion
-
- Required: Yes
- Type: string
A string that contains the package version (for example,
3.5.2
). - packageVersionRevision
-
- Type: string
The name of the package version revision that contains the requested asset.
- repository
-
- Required: Yes
- Type: string
The repository that contains the package version with the requested asset.
Result Syntax
[ 'asset' => <string || resource || Psr\Http\Message\StreamInterface>, 'assetName' => '<string>', 'packageVersion' => '<string>', 'packageVersionRevision' => '<string>', ]
Result Details
Members
- asset
-
- Type: blob (string|resource|Psr\Http\Message\StreamInterface)
The binary file, or asset, that is downloaded.
- assetName
-
- Type: string
The name of the asset that is downloaded.
- packageVersion
-
- Type: string
A string that contains the package version (for example,
3.5.2
). - packageVersionRevision
-
- Type: string
The name of the package version revision that contains the downloaded asset.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
- ConflictException:
The operation did not succeed because prerequisites are not met.
GetPackageVersionReadme
$result = $client->getPackageVersionReadme
([/* ... */]); $promise = $client->getPackageVersionReadmeAsync
([/* ... */]);
Gets the readme file or descriptive text for a package version.
The returned text might contain formatting. For example, it might contain formatting for Markdown or reStructuredText.
Parameter Syntax
$result = $client->getPackageVersionReadme([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'namespace' => '<string>', 'package' => '<string>', // REQUIRED 'packageVersion' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository that contains the package version with the requested readme file.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- format
-
- Required: Yes
- Type: string
A format that specifies the type of the package version with the requested readme file.
- namespace
-
- Type: string
The namespace of the package version with the requested readme file. The package component that specifies its namespace depends on its type. For example:
The namespace is required when requesting the readme from package versions of the following formats:
-
Maven
-
Swift
-
generic
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Required: Yes
- Type: string
The name of the package version that contains the requested readme file.
- packageVersion
-
- Required: Yes
- Type: string
A string that contains the package version (for example,
3.5.2
). - repository
-
- Required: Yes
- Type: string
The repository that contains the package with the requested readme file.
Result Syntax
[ 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'namespace' => '<string>', 'package' => '<string>', 'readme' => '<string>', 'version' => '<string>', 'versionRevision' => '<string>', ]
Result Details
Members
- format
-
- Type: string
The format of the package with the requested readme file.
- namespace
-
- Type: string
The namespace of the package version with the requested readme file. The package component that specifies its namespace depends on its type. For example:
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Type: string
The name of the package that contains the returned readme file.
- readme
-
- Type: string
The text of the returned readme file.
- version
-
- Type: string
The version of the package with the requested readme file.
- versionRevision
-
- Type: string
The current revision associated with the package version.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
GetRepositoryEndpoint
$result = $client->getRepositoryEndpoint
([/* ... */]); $promise = $client->getRepositoryEndpointAsync
([/* ... */]);
Returns the endpoint of a repository for a specific package format. A repository has one endpoint for each package format:
-
cargo
-
generic
-
maven
-
npm
-
nuget
-
pypi
-
ruby
-
swift
Parameter Syntax
$result = $client->getRepositoryEndpoint([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'endpointType' => 'dualstack|ipv4', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain that contains the repository. It does not include dashes or spaces.
- endpointType
-
- Type: string
A string that specifies the type of endpoint.
- format
-
- Required: Yes
- Type: string
Returns which endpoint of a repository to return. A repository has one endpoint for each package format.
- repository
-
- Required: Yes
- Type: string
The name of the repository.
Result Syntax
[ 'repositoryEndpoint' => '<string>', ]
Result Details
Members
- repositoryEndpoint
-
- Type: string
A string that specifies the URL of the returned endpoint.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
GetRepositoryPermissionsPolicy
$result = $client->getRepositoryPermissionsPolicy
([/* ... */]); $promise = $client->getRepositoryPermissionsPolicyAsync
([/* ... */]);
Returns the resource policy that is set on a repository.
Parameter Syntax
$result = $client->getRepositoryPermissionsPolicy([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain containing the repository whose associated resource policy is to be retrieved.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- repository
-
- Required: Yes
- Type: string
The name of the repository whose associated resource policy is to be retrieved.
Result Syntax
[ 'policy' => [ 'document' => '<string>', 'resourceArn' => '<string>', 'revision' => '<string>', ], ]
Result Details
Members
- policy
-
- Type: ResourcePolicy structure
The returned resource policy.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
ListAllowedRepositoriesForGroup
$result = $client->listAllowedRepositoriesForGroup
([/* ... */]); $promise = $client->listAllowedRepositoriesForGroupAsync
([/* ... */]);
Lists the repositories in the added repositories list of the specified restriction type for a package group. For more information about restriction types and added repository lists, see Package group origin controls in the CodeArtifact User Guide.
Parameter Syntax
$result = $client->listAllowedRepositoriesForGroup([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'maxResults' => <integer>, 'nextToken' => '<string>', 'originRestrictionType' => 'EXTERNAL_UPSTREAM|INTERNAL_UPSTREAM|PUBLISH', // REQUIRED 'packageGroup' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the package group from which to list allowed repositories.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- originRestrictionType
-
- Required: Yes
- Type: string
The origin configuration restriction type of which to list allowed repositories.
- packageGroup
-
- Required: Yes
- Type: string
The pattern of the package group from which to list allowed repositories.
Result Syntax
[ 'allowedRepositories' => ['<string>', ...], 'nextToken' => '<string>', ]
Result Details
Members
- allowedRepositories
-
- Type: Array of strings
The list of allowed repositories for the package group and origin configuration restriction type.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
ListAssociatedPackages
$result = $client->listAssociatedPackages
([/* ... */]); $promise = $client->listAssociatedPackagesAsync
([/* ... */]);
Returns a list of packages associated with the requested package group. For information package group association and matching, see Package group definition syntax and matching behavior in the CodeArtifact User Guide.
Parameter Syntax
$result = $client->listAssociatedPackages([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'maxResults' => <integer>, 'nextToken' => '<string>', 'packageGroup' => '<string>', // REQUIRED 'preview' => true || false, ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the package group from which to list associated packages.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- packageGroup
-
- Required: Yes
- Type: string
The pattern of the package group from which to list associated packages.
- preview
-
- Type: boolean
When this flag is included,
ListAssociatedPackages
will return a list of packages that would be associated with a package group, even if it does not exist.
Result Syntax
[ 'nextToken' => '<string>', 'packages' => [ [ 'associationType' => 'STRONG|WEAK', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'namespace' => '<string>', 'package' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- packages
-
- Type: Array of AssociatedPackage structures
The list of packages associated with the requested package group.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
ListDomains
$result = $client->listDomains
([/* ... */]); $promise = $client->listDomainsAsync
([/* ... */]);
Returns a list of DomainSummary objects for all domains owned by the Amazon Web Services account that makes this call. Each returned DomainSummary
object contains information about a domain.
Parameter Syntax
$result = $client->listDomains([ 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
Result Syntax
[ 'domains' => [ [ 'arn' => '<string>', 'createdTime' => <DateTime>, 'encryptionKey' => '<string>', 'name' => '<string>', 'owner' => '<string>', 'status' => 'Active|Deleted', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- domains
-
- Type: Array of DomainSummary structures
The returned list of DomainSummary objects.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
ListPackageGroups
$result = $client->listPackageGroups
([/* ... */]); $promise = $client->listPackageGroupsAsync
([/* ... */]);
Returns a list of package groups in the requested domain.
Parameter Syntax
$result = $client->listPackageGroups([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'maxResults' => <integer>, 'nextToken' => '<string>', 'prefix' => '<string>', ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The domain for which you want to list package groups.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- prefix
-
- Type: string
A prefix for which to search package groups. When included,
ListPackageGroups
will return only package groups with patterns that match the prefix.
Result Syntax
[ 'nextToken' => '<string>', 'packageGroups' => [ [ 'arn' => '<string>', 'contactInfo' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'originConfiguration' => [ 'restrictions' => [ '<PackageGroupOriginRestrictionType>' => [ 'effectiveMode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'inheritedFrom' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'mode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'repositoriesCount' => <integer>, ], // ... ], ], 'parent' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'pattern' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- packageGroups
-
- Type: Array of PackageGroupSummary structures
The list of package groups in the requested domain.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
ListPackageVersionAssets
$result = $client->listPackageVersionAssets
([/* ... */]); $promise = $client->listPackageVersionAssetsAsync
([/* ... */]);
Returns a list of AssetSummary objects for assets in a package version.
Parameter Syntax
$result = $client->listPackageVersionAssets([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'maxResults' => <integer>, 'namespace' => '<string>', 'nextToken' => '<string>', 'package' => '<string>', // REQUIRED 'packageVersion' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository associated with the package version assets.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- format
-
- Required: Yes
- Type: string
The format of the package that contains the requested package version assets.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- namespace
-
- Type: string
The namespace of the package version that contains the requested package version assets. The package component that specifies its namespace depends on its type. For example:
The namespace is required requesting assets from package versions of the following formats:
-
Maven
-
Swift
-
generic
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- package
-
- Required: Yes
- Type: string
The name of the package that contains the requested package version assets.
- packageVersion
-
- Required: Yes
- Type: string
A string that contains the package version (for example,
3.5.2
). - repository
-
- Required: Yes
- Type: string
The name of the repository that contains the package that contains the requested package version assets.
Result Syntax
[ 'assets' => [ [ 'hashes' => ['<string>', ...], 'name' => '<string>', 'size' => <integer>, ], // ... ], 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'namespace' => '<string>', 'nextToken' => '<string>', 'package' => '<string>', 'version' => '<string>', 'versionRevision' => '<string>', ]
Result Details
Members
- assets
-
- Type: Array of AssetSummary structures
The returned list of AssetSummary objects.
- format
-
- Type: string
The format of the package that contains the requested package version assets.
- namespace
-
- Type: string
The namespace of the package version that contains the requested package version assets. The package component that specifies its namespace depends on its type. For example:
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
- package
-
- Type: string
The name of the package that contains the requested package version assets.
- version
-
- Type: string
The version of the package associated with the requested assets.
- versionRevision
-
- Type: string
The current revision associated with the package version.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
ListPackageVersionDependencies
$result = $client->listPackageVersionDependencies
([/* ... */]); $promise = $client->listPackageVersionDependenciesAsync
([/* ... */]);
Returns the direct dependencies for a package version. The dependencies are returned as PackageDependency objects. CodeArtifact extracts the dependencies for a package version from the metadata file for the package format (for example, the package.json
file for npm packages and the pom.xml
file for Maven). Any package version dependencies that are not listed in the configuration file are not returned.
Parameter Syntax
$result = $client->listPackageVersionDependencies([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'namespace' => '<string>', 'nextToken' => '<string>', 'package' => '<string>', // REQUIRED 'packageVersion' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository that contains the requested package version dependencies.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- format
-
- Required: Yes
- Type: string
The format of the package with the requested dependencies.
- namespace
-
- Type: string
The namespace of the package version with the requested dependencies. The package component that specifies its namespace depends on its type. For example:
The namespace is required when listing dependencies from package versions of the following formats:
-
Maven
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm package version is its
scope
. -
Python and NuGet package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- package
-
- Required: Yes
- Type: string
The name of the package versions' package.
- packageVersion
-
- Required: Yes
- Type: string
A string that contains the package version (for example,
3.5.2
). - repository
-
- Required: Yes
- Type: string
The name of the repository that contains the requested package version.
Result Syntax
[ 'dependencies' => [ [ 'dependencyType' => '<string>', 'namespace' => '<string>', 'package' => '<string>', 'versionRequirement' => '<string>', ], // ... ], 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'namespace' => '<string>', 'nextToken' => '<string>', 'package' => '<string>', 'version' => '<string>', 'versionRevision' => '<string>', ]
Result Details
Members
- dependencies
-
- Type: Array of PackageDependency structures
The returned list of PackageDependency objects.
- format
-
- Type: string
A format that specifies the type of the package that contains the returned dependencies.
- namespace
-
- Type: string
The namespace of the package version that contains the returned dependencies. The package component that specifies its namespace depends on its type. For example:
The namespace is required when listing dependencies from package versions of the following formats:
-
Maven
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm package version is its
scope
. -
Python and NuGet package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- package
-
- Type: string
The name of the package that contains the returned package versions dependencies.
- version
-
- Type: string
The version of the package that is specified in the request.
- versionRevision
-
- Type: string
The current revision associated with the package version.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
ListPackageVersions
$result = $client->listPackageVersions
([/* ... */]); $promise = $client->listPackageVersionsAsync
([/* ... */]);
Returns a list of PackageVersionSummary objects for package versions in a repository that match the request parameters. Package versions of all statuses will be returned by default when calling list-package-versions
with no --status
parameter.
Parameter Syntax
$result = $client->listPackageVersions([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'maxResults' => <integer>, 'namespace' => '<string>', 'nextToken' => '<string>', 'originType' => 'INTERNAL|EXTERNAL|UNKNOWN', 'package' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED 'sortBy' => 'PUBLISHED_TIME', 'status' => 'Published|Unfinished|Unlisted|Archived|Disposed|Deleted', ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository that contains the requested package versions.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- format
-
- Required: Yes
- Type: string
The format of the package versions you want to list.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- namespace
-
- Type: string
The namespace of the package that contains the requested package versions. The package component that specifies its namespace depends on its type. For example:
The namespace is required when deleting package versions of the following formats:
-
Maven
-
Swift
-
generic
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- originType
-
- Type: string
The
originType
used to filter package versions. Only package versions with the providedoriginType
will be returned. - package
-
- Required: Yes
- Type: string
The name of the package for which you want to request package versions.
- repository
-
- Required: Yes
- Type: string
The name of the repository that contains the requested package versions.
- sortBy
-
- Type: string
How to sort the requested list of package versions.
- status
-
- Type: string
A string that filters the requested package versions by status.
Result Syntax
[ 'defaultDisplayVersion' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'namespace' => '<string>', 'nextToken' => '<string>', 'package' => '<string>', 'versions' => [ [ 'origin' => [ 'domainEntryPoint' => [ 'externalConnectionName' => '<string>', 'repositoryName' => '<string>', ], 'originType' => 'INTERNAL|EXTERNAL|UNKNOWN', ], 'revision' => '<string>', 'status' => 'Published|Unfinished|Unlisted|Archived|Disposed|Deleted', 'version' => '<string>', ], // ... ], ]
Result Details
Members
- defaultDisplayVersion
-
- Type: string
The default package version to display. This depends on the package format:
-
For Maven and PyPI packages, it's the most recently published package version.
-
For npm packages, it's the version referenced by the
latest
tag. If thelatest
tag is not set, it's the most recently published package version.
- format
-
- Type: string
A format of the package.
- namespace
-
- Type: string
The namespace of the package that contains the requested package versions. The package component that specifies its namespace depends on its type. For example:
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
- package
-
- Type: string
The name of the package.
- versions
-
- Type: Array of PackageVersionSummary structures
The returned list of PackageVersionSummary objects.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
ListPackages
$result = $client->listPackages
([/* ... */]); $promise = $client->listPackagesAsync
([/* ... */]);
Returns a list of PackageSummary objects for packages in a repository that match the request parameters.
Parameter Syntax
$result = $client->listPackages([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'maxResults' => <integer>, 'namespace' => '<string>', 'nextToken' => '<string>', 'packagePrefix' => '<string>', 'publish' => 'ALLOW|BLOCK', 'repository' => '<string>', // REQUIRED 'upstream' => 'ALLOW|BLOCK', ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository that contains the requested packages.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- format
-
- Type: string
The format used to filter requested packages. Only packages from the provided format will be returned.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- namespace
-
- Type: string
The namespace prefix used to filter requested packages. Only packages with a namespace that starts with the provided string value are returned. Note that although this option is called
--namespace
and not--namespace-prefix
, it has prefix-matching behavior.Each package format uses namespace as follows:
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- packagePrefix
-
- Type: string
A prefix used to filter requested packages. Only packages with names that start with
packagePrefix
are returned. - publish
-
- Type: string
The value of the
Publish
package origin control restriction used to filter requested packages. Only packages with the provided restriction are returned. For more information, see PackageOriginRestrictions. - repository
-
- Required: Yes
- Type: string
The name of the repository that contains the requested packages.
- upstream
-
- Type: string
The value of the
Upstream
package origin control restriction used to filter requested packages. Only packages with the provided restriction are returned. For more information, see PackageOriginRestrictions.
Result Syntax
[ 'nextToken' => '<string>', 'packages' => [ [ 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'namespace' => '<string>', 'originConfiguration' => [ 'restrictions' => [ 'publish' => 'ALLOW|BLOCK', 'upstream' => 'ALLOW|BLOCK', ], ], 'package' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
- packages
-
- Type: Array of PackageSummary structures
The list of returned PackageSummary objects.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
ListRepositories
$result = $client->listRepositories
([/* ... */]); $promise = $client->listRepositoriesAsync
([/* ... */]);
Returns a list of RepositorySummary objects. Each RepositorySummary
contains information about a repository in the specified Amazon Web Services account and that matches the input parameters.
Parameter Syntax
$result = $client->listRepositories([ 'maxResults' => <integer>, 'nextToken' => '<string>', 'repositoryPrefix' => '<string>', ]);
Parameter Details
Members
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- repositoryPrefix
-
- Type: string
A prefix used to filter returned repositories. Only repositories with names that start with
repositoryPrefix
are returned.
Result Syntax
[ 'nextToken' => '<string>', 'repositories' => [ [ 'administratorAccount' => '<string>', 'arn' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'name' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
- repositories
-
- Type: Array of RepositorySummary structures
The returned list of RepositorySummary objects.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
ListRepositoriesInDomain
$result = $client->listRepositoriesInDomain
([/* ... */]); $promise = $client->listRepositoriesInDomainAsync
([/* ... */]);
Returns a list of RepositorySummary objects. Each RepositorySummary
contains information about a repository in the specified domain and that matches the input parameters.
Parameter Syntax
$result = $client->listRepositoriesInDomain([ 'administratorAccount' => '<string>', 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'maxResults' => <integer>, 'nextToken' => '<string>', 'repositoryPrefix' => '<string>', ]);
Parameter Details
Members
- administratorAccount
-
- Type: string
Filter the list of repositories to only include those that are managed by the Amazon Web Services account ID.
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the returned list of repositories.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- repositoryPrefix
-
- Type: string
A prefix used to filter returned repositories. Only repositories with names that start with
repositoryPrefix
are returned.
Result Syntax
[ 'nextToken' => '<string>', 'repositories' => [ [ 'administratorAccount' => '<string>', 'arn' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'name' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
- repositories
-
- Type: Array of RepositorySummary structures
The returned list of repositories.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
ListSubPackageGroups
$result = $client->listSubPackageGroups
([/* ... */]); $promise = $client->listSubPackageGroupsAsync
([/* ... */]);
Returns a list of direct children of the specified package group.
For information package group hierarchy, see Package group definition syntax and matching behavior in the CodeArtifact User Guide.
Parameter Syntax
$result = $client->listSubPackageGroups([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'maxResults' => <integer>, 'nextToken' => '<string>', 'packageGroup' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain which contains the package group from which to list sub package groups.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
- packageGroup
-
- Required: Yes
- Type: string
The pattern of the package group from which to list sub package groups.
Result Syntax
[ 'nextToken' => '<string>', 'packageGroups' => [ [ 'arn' => '<string>', 'contactInfo' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'originConfiguration' => [ 'restrictions' => [ '<PackageGroupOriginRestrictionType>' => [ 'effectiveMode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'inheritedFrom' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'mode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'repositoriesCount' => <integer>, ], // ... ], ], 'parent' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'pattern' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
- packageGroups
-
- Type: Array of PackageGroupSummary structures
A list of sub package groups for the requested package group.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
ListTagsForResource
$result = $client->listTagsForResource
([/* ... */]); $promise = $client->listTagsForResourceAsync
([/* ... */]);
Gets information about Amazon Web Services tags for a specified Amazon Resource Name (ARN) in CodeArtifact.
Parameter Syntax
$result = $client->listTagsForResource([ 'resourceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the resource to get tags for.
Result Syntax
[ 'tags' => [ [ 'key' => '<string>', 'value' => '<string>', ], // ... ], ]
Result Details
Members
- tags
-
- Type: Array of Tag structures
A list of tag key and value pairs associated with the specified resource.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
PublishPackageVersion
$result = $client->publishPackageVersion
([/* ... */]); $promise = $client->publishPackageVersionAsync
([/* ... */]);
Creates a new package version containing one or more assets (or files).
The unfinished
flag can be used to keep the package version in the Unfinished
state until all of its assets have been uploaded (see Package version status in the CodeArtifact user guide). To set the package versionâs status to Published
, omit the unfinished
flag when uploading the final asset, or set the status using UpdatePackageVersionStatus. Once a package versionâs status is set to Published
, it cannot change back to Unfinished
.
Only generic packages can be published using this API. For more information, see Using generic packages in the CodeArtifact User Guide.
Parameter Syntax
$result = $client->publishPackageVersion([ 'assetContent' => <string || resource || Psr\Http\Message\StreamInterface>, // REQUIRED 'assetName' => '<string>', // REQUIRED 'assetSHA256' => '<string>', // REQUIRED 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'namespace' => '<string>', 'package' => '<string>', // REQUIRED 'packageVersion' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED 'unfinished' => true || false, ]);
Parameter Details
Members
- assetContent
-
- Required: Yes
- Type: blob (string|resource|Psr\Http\Message\StreamInterface)
The content of the asset to publish.
- assetName
-
- Required: Yes
- Type: string
The name of the asset to publish. Asset names can include Unicode letters and numbers, and the following special characters:
~ ! @ ^ & ( ) - ` _ + [ ] { } ; , . `
- assetSHA256
-
- Required: Yes
- Type: string
The SHA256 hash of the
assetContent
to publish. This value must be calculated by the caller and provided with the request (see Publishing a generic package in the CodeArtifact User Guide).This value is used as an integrity check to verify that the
assetContent
has not changed after it was originally sent. - domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository that contains the package version to publish.
- domainOwner
-
- Type: string
The 12-digit account number of the AWS account that owns the domain. It does not include dashes or spaces.
- format
-
- Required: Yes
- Type: string
A format that specifies the type of the package version with the requested asset file.
The only supported value is
generic
. - namespace
-
- Type: string
The namespace of the package version to publish.
- package
-
- Required: Yes
- Type: string
The name of the package version to publish.
- packageVersion
-
- Required: Yes
- Type: string
The package version to publish (for example,
3.5.2
). - repository
-
- Required: Yes
- Type: string
The name of the repository that the package version will be published to.
- unfinished
-
- Type: boolean
Specifies whether the package version should remain in the
unfinished
state. If omitted, the package version status will be set toPublished
(see Package version status in the CodeArtifact User Guide).Valid values:
unfinished
Result Syntax
[ 'asset' => [ 'hashes' => ['<string>', ...], 'name' => '<string>', 'size' => <integer>, ], 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'namespace' => '<string>', 'package' => '<string>', 'status' => 'Published|Unfinished|Unlisted|Archived|Disposed|Deleted', 'version' => '<string>', 'versionRevision' => '<string>', ]
Result Details
Members
- asset
-
- Type: AssetSummary structure
An AssetSummary for the published asset.
- format
-
- Type: string
The format of the package version.
- namespace
-
- Type: string
The namespace of the package version.
- package
-
- Type: string
The name of the package.
- status
-
- Type: string
A string that contains the status of the package version. For more information, see Package version status in the CodeArtifact User Guide.
- version
-
- Type: string
The version of the package.
- versionRevision
-
- Type: string
The revision of the package version.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
PutDomainPermissionsPolicy
$result = $client->putDomainPermissionsPolicy
([/* ... */]); $promise = $client->putDomainPermissionsPolicyAsync
([/* ... */]);
Sets a resource policy on a domain that specifies permissions to access it.
When you call PutDomainPermissionsPolicy
, the resource policy on the domain is ignored when evaluting permissions. This ensures that the owner of a domain cannot lock themselves out of the domain, which would prevent them from being able to update the resource policy.
Parameter Syntax
$result = $client->putDomainPermissionsPolicy([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'policyDocument' => '<string>', // REQUIRED 'policyRevision' => '<string>', ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain on which to set the resource policy.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- policyDocument
-
- Required: Yes
- Type: string
A valid displayable JSON Aspen policy string to be set as the access control resource policy on the provided domain.
- policyRevision
-
- Type: string
The current revision of the resource policy to be set. This revision is used for optimistic locking, which prevents others from overwriting your changes to the domain's resource policy.
Result Syntax
[ 'policy' => [ 'document' => '<string>', 'resourceArn' => '<string>', 'revision' => '<string>', ], ]
Result Details
Members
- policy
-
- Type: ResourcePolicy structure
The resource policy that was set after processing the request.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
PutPackageOriginConfiguration
$result = $client->putPackageOriginConfiguration
([/* ... */]); $promise = $client->putPackageOriginConfigurationAsync
([/* ... */]);
Sets the package origin configuration for a package.
The package origin configuration determines how new versions of a package can be added to a repository. You can allow or block direct publishing of new package versions, or ingestion and retaining of new package versions from an external connection or upstream source. For more information about package origin controls and configuration, see Editing package origin controls in the CodeArtifact User Guide.
PutPackageOriginConfiguration
can be called on a package that doesn't yet exist in the repository. When called on a package that does not exist, a package is created in the repository with no versions and the requested restrictions are set on the package. This can be used to preemptively block ingesting or retaining any versions from external connections or upstream repositories, or to block publishing any versions of the package into the repository before connecting any package managers or publishers to the repository.
Parameter Syntax
$result = $client->putPackageOriginConfiguration([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'namespace' => '<string>', 'package' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED 'restrictions' => [ // REQUIRED 'publish' => 'ALLOW|BLOCK', // REQUIRED 'upstream' => 'ALLOW|BLOCK', // REQUIRED ], ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository that contains the package.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- format
-
- Required: Yes
- Type: string
A format that specifies the type of the package to be updated.
- namespace
-
- Type: string
The namespace of the package to be updated. The package component that specifies its namespace depends on its type. For example:
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Required: Yes
- Type: string
The name of the package to be updated.
- repository
-
- Required: Yes
- Type: string
The name of the repository that contains the package.
- restrictions
-
- Required: Yes
- Type: PackageOriginRestrictions structure
A PackageOriginRestrictions object that contains information about the
upstream
andpublish
package origin restrictions. Theupstream
restriction determines if new package versions can be ingested or retained from external connections or upstream repositories. Thepublish
restriction determines if new package versions can be published directly to the repository.You must include both the desired
upstream
andpublish
restrictions.
Result Syntax
[ 'originConfiguration' => [ 'restrictions' => [ 'publish' => 'ALLOW|BLOCK', 'upstream' => 'ALLOW|BLOCK', ], ], ]
Result Details
Members
- originConfiguration
-
- Type: PackageOriginConfiguration structure
A PackageOriginConfiguration object that describes the origin configuration set for the package. It contains a PackageOriginRestrictions object that describes how new versions of the package can be introduced to the repository.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
PutRepositoryPermissionsPolicy
$result = $client->putRepositoryPermissionsPolicy
([/* ... */]); $promise = $client->putRepositoryPermissionsPolicyAsync
([/* ... */]);
Sets the resource policy on a repository that specifies permissions to access it.
When you call PutRepositoryPermissionsPolicy
, the resource policy on the repository is ignored when evaluting permissions. This ensures that the owner of a repository cannot lock themselves out of the repository, which would prevent them from being able to update the resource policy.
Parameter Syntax
$result = $client->putRepositoryPermissionsPolicy([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'policyDocument' => '<string>', // REQUIRED 'policyRevision' => '<string>', 'repository' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain containing the repository to set the resource policy on.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- policyDocument
-
- Required: Yes
- Type: string
A valid displayable JSON Aspen policy string to be set as the access control resource policy on the provided repository.
- policyRevision
-
- Type: string
Sets the revision of the resource policy that specifies permissions to access the repository. This revision is used for optimistic locking, which prevents others from overwriting your changes to the repository's resource policy.
- repository
-
- Required: Yes
- Type: string
The name of the repository to set the resource policy on.
Result Syntax
[ 'policy' => [ 'document' => '<string>', 'resourceArn' => '<string>', 'revision' => '<string>', ], ]
Result Details
Members
- policy
-
- Type: ResourcePolicy structure
The resource policy that was set after processing the request.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
TagResource
$result = $client->tagResource
([/* ... */]); $promise = $client->tagResourceAsync
([/* ... */]);
Adds or updates tags for a resource in CodeArtifact.
Parameter Syntax
$result = $client->tagResource([ 'resourceArn' => '<string>', // REQUIRED 'tags' => [ // REQUIRED [ 'key' => '<string>', // REQUIRED 'value' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the resource that you want to add or update tags for.
- tags
-
- Required: Yes
- Type: Array of Tag structures
The tags you want to modify or add to the resource.
Result Syntax
[]
Result Details
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
UntagResource
$result = $client->untagResource
([/* ... */]); $promise = $client->untagResourceAsync
([/* ... */]);
Removes tags from a resource in CodeArtifact.
Parameter Syntax
$result = $client->untagResource([ 'resourceArn' => '<string>', // REQUIRED 'tagKeys' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the resource that you want to remove tags from.
- tagKeys
-
- Required: Yes
- Type: Array of strings
The tag key for each tag that you want to remove from the resource.
Result Syntax
[]
Result Details
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
UpdatePackageGroup
$result = $client->updatePackageGroup
([/* ... */]); $promise = $client->updatePackageGroupAsync
([/* ... */]);
Updates a package group. This API cannot be used to update a package group's origin configuration or pattern. To update a package group's origin configuration, use UpdatePackageGroupOriginConfiguration.
Parameter Syntax
$result = $client->updatePackageGroup([ 'contactInfo' => '<string>', 'description' => '<string>', 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'packageGroup' => '<string>', // REQUIRED ]);
Parameter Details
Members
- contactInfo
-
- Type: string
Contact information which you want to update the requested package group with.
- description
-
- Type: string
The description you want to update the requested package group with.
- domain
-
- Required: Yes
- Type: string
The name of the domain which contains the package group to be updated.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- packageGroup
-
- Required: Yes
- Type: string
The pattern of the package group to be updated.
Result Syntax
[ 'packageGroup' => [ 'arn' => '<string>', 'contactInfo' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'originConfiguration' => [ 'restrictions' => [ '<PackageGroupOriginRestrictionType>' => [ 'effectiveMode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'inheritedFrom' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'mode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'repositoriesCount' => <integer>, ], // ... ], ], 'parent' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'pattern' => '<string>', ], ]
Result Details
Members
- packageGroup
-
- Type: PackageGroupDescription structure
The package group and information about it after the request has been processed.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
UpdatePackageGroupOriginConfiguration
$result = $client->updatePackageGroupOriginConfiguration
([/* ... */]); $promise = $client->updatePackageGroupOriginConfigurationAsync
([/* ... */]);
Updates the package origin configuration for a package group.
The package origin configuration determines how new versions of a package can be added to a repository. You can allow or block direct publishing of new package versions, or ingestion and retaining of new package versions from an external connection or upstream source. For more information about package group origin controls and configuration, see Package group origin controls in the CodeArtifact User Guide.
Parameter Syntax
$result = $client->updatePackageGroupOriginConfiguration([ 'addAllowedRepositories' => [ [ 'originRestrictionType' => 'EXTERNAL_UPSTREAM|INTERNAL_UPSTREAM|PUBLISH', 'repositoryName' => '<string>', ], // ... ], 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'packageGroup' => '<string>', // REQUIRED 'removeAllowedRepositories' => [ [ 'originRestrictionType' => 'EXTERNAL_UPSTREAM|INTERNAL_UPSTREAM|PUBLISH', 'repositoryName' => '<string>', ], // ... ], 'restrictions' => ['<string>', ...], ]);
Parameter Details
Members
- addAllowedRepositories
-
- Type: Array of PackageGroupAllowedRepository structures
The repository name and restrictions to add to the allowed repository list of the specified package group.
- domain
-
- Required: Yes
- Type: string
The name of the domain which contains the package group for which to update the origin configuration.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- packageGroup
-
- Required: Yes
- Type: string
The pattern of the package group for which to update the origin configuration.
- removeAllowedRepositories
-
- Type: Array of PackageGroupAllowedRepository structures
The repository name and restrictions to remove from the allowed repository list of the specified package group.
- restrictions
-
- Type: Associative array of custom strings keys (PackageGroupOriginRestrictionType) to strings
The origin configuration settings that determine how package versions can enter repositories.
Result Syntax
[ 'allowedRepositoryUpdates' => [ '<PackageGroupOriginRestrictionType>' => [ '<PackageGroupAllowedRepositoryUpdateType>' => ['<string>', ...], // ... ], // ... ], 'packageGroup' => [ 'arn' => '<string>', 'contactInfo' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'originConfiguration' => [ 'restrictions' => [ '<PackageGroupOriginRestrictionType>' => [ 'effectiveMode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'inheritedFrom' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'mode' => 'ALLOW|ALLOW_SPECIFIC_REPOSITORIES|BLOCK|INHERIT', 'repositoriesCount' => <integer>, ], // ... ], ], 'parent' => [ 'arn' => '<string>', 'pattern' => '<string>', ], 'pattern' => '<string>', ], ]
Result Details
Members
- allowedRepositoryUpdates
-
- Type: Associative array of custom strings keys (PackageGroupOriginRestrictionType) to maps
Information about the updated allowed repositories after processing the request.
- packageGroup
-
- Type: PackageGroupDescription structure
The package group and information about it after processing the request.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
UpdatePackageVersionsStatus
$result = $client->updatePackageVersionsStatus
([/* ... */]); $promise = $client->updatePackageVersionsStatusAsync
([/* ... */]);
Updates the status of one or more versions of a package. Using UpdatePackageVersionsStatus
, you can update the status of package versions to Archived
, Published
, or Unlisted
. To set the status of a package version to Disposed
, use DisposePackageVersions.
Parameter Syntax
$result = $client->updatePackageVersionsStatus([ 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'expectedStatus' => 'Published|Unfinished|Unlisted|Archived|Disposed|Deleted', 'format' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', // REQUIRED 'namespace' => '<string>', 'package' => '<string>', // REQUIRED 'repository' => '<string>', // REQUIRED 'targetStatus' => 'Published|Unfinished|Unlisted|Archived|Disposed|Deleted', // REQUIRED 'versionRevisions' => ['<string>', ...], 'versions' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- domain
-
- Required: Yes
- Type: string
The name of the domain that contains the repository that contains the package versions with a status to be updated.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- expectedStatus
-
- Type: string
The package versionâs expected status before it is updated. If
expectedStatus
is provided, the package version's status is updated only if its status at the timeUpdatePackageVersionsStatus
is called matchesexpectedStatus
. - format
-
- Required: Yes
- Type: string
A format that specifies the type of the package with the statuses to update.
- namespace
-
- Type: string
The namespace of the package version to be updated. The package component that specifies its namespace depends on its type. For example:
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Required: Yes
- Type: string
The name of the package with the version statuses to update.
- repository
-
- Required: Yes
- Type: string
The repository that contains the package versions with the status you want to update.
- targetStatus
-
- Required: Yes
- Type: string
The status you want to change the package version status to.
- versionRevisions
-
- Type: Associative array of custom strings keys (PackageVersion) to strings
A map of package versions and package version revisions. The map
key
is the package version (for example,3.5.2
), and the mapvalue
is the package version revision. - versions
-
- Required: Yes
- Type: Array of strings
An array of strings that specify the versions of the package with the statuses to update.
Result Syntax
[ 'failedVersions' => [ '<PackageVersion>' => [ 'errorCode' => 'ALREADY_EXISTS|MISMATCHED_REVISION|MISMATCHED_STATUS|NOT_ALLOWED|NOT_FOUND|SKIPPED', 'errorMessage' => '<string>', ], // ... ], 'successfulVersions' => [ '<PackageVersion>' => [ 'revision' => '<string>', 'status' => 'Published|Unfinished|Unlisted|Archived|Disposed|Deleted', ], // ... ], ]
Result Details
Members
- failedVersions
-
- Type: Associative array of custom strings keys (PackageVersion) to PackageVersionError structures
A list of
SuccessfulPackageVersionInfo
objects, one for each package version with a status that successfully updated. - successfulVersions
-
- Type: Associative array of custom strings keys (PackageVersion) to SuccessfulPackageVersionInfo structures
A list of
PackageVersionError
objects, one for each package version with a status that failed to update.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
UpdateRepository
$result = $client->updateRepository
([/* ... */]); $promise = $client->updateRepositoryAsync
([/* ... */]);
Update the properties of a repository.
Parameter Syntax
$result = $client->updateRepository([ 'description' => '<string>', 'domain' => '<string>', // REQUIRED 'domainOwner' => '<string>', 'repository' => '<string>', // REQUIRED 'upstreams' => [ [ 'repositoryName' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- description
-
- Type: string
An updated repository description.
- domain
-
- Required: Yes
- Type: string
The name of the domain associated with the repository to update.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- repository
-
- Required: Yes
- Type: string
The name of the repository to update.
- upstreams
-
- Type: Array of UpstreamRepository structures
A list of upstream repositories to associate with the repository. The order of the upstream repositories in the list determines their priority order when CodeArtifact looks for a requested package version. For more information, see Working with upstream repositories.
Result Syntax
[ 'repository' => [ 'administratorAccount' => '<string>', 'arn' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'domainName' => '<string>', 'domainOwner' => '<string>', 'externalConnections' => [ [ 'externalConnectionName' => '<string>', 'packageFormat' => 'npm|pypi|maven|nuget|generic|ruby|swift|cargo', 'status' => 'Available', ], // ... ], 'name' => '<string>', 'upstreams' => [ [ 'repositoryName' => '<string>', ], // ... ], ], ]
Result Details
Members
- repository
-
- Type: RepositoryDescription structure
The updated repository.
Errors
- AccessDeniedException:
The operation did not succeed because of an unauthorized access attempt.
- ConflictException:
The operation did not succeed because prerequisites are not met.
- InternalServerException:
The operation did not succeed because of an error that occurred inside CodeArtifact.
- ResourceNotFoundException:
The operation did not succeed because the resource requested is not found in the service.
- ServiceQuotaExceededException:
The operation did not succeed because it would have exceeded a service limit for your account.
- ThrottlingException:
The operation did not succeed because too many requests are sent to the service.
- ValidationException:
The operation did not succeed because a parameter in the request was sent with an invalid value.
Shapes
AccessDeniedException
Description
The operation did not succeed because of an unauthorized access attempt.
Members
- message
-
- Required: Yes
- Type: string
AssetSummary
Description
Contains details about a package version asset.
Members
- hashes
-
- Type: Associative array of custom strings keys (HashAlgorithm) to strings
The hashes of the asset.
- name
-
- Required: Yes
- Type: string
The name of the asset.
- size
-
- Type: long (int|float)
The size of the asset.
AssociatedPackage
Description
A package associated with a package group.
Members
- associationType
-
- Type: string
Describes the strength of the association between the package and package group. A strong match can be thought of as an exact match, and a weak match can be thought of as a variation match, for example, the package name matches a variation of the package group pattern. For more information about package group pattern matching, including strong and weak matches, see Package group definition syntax and matching behavior in the CodeArtifact User Guide.
- format
-
- Type: string
A format that specifies the type of the associated package.
- namespace
-
- Type: string
The namespace of the associated package. The package component that specifies its namespace depends on its type. For example:
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Type: string
The name of the associated package.
ConflictException
Description
The operation did not succeed because prerequisites are not met.
Members
- message
-
- Required: Yes
- Type: string
- resourceId
-
- Type: string
The ID of the resource.
- resourceType
-
- Type: string
The type of Amazon Web Services resource.
DomainDescription
Description
Information about a domain. A domain is a container for repositories. When you create a domain, it is empty until you add one or more repositories.
Members
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the domain.
- assetSizeBytes
-
- Type: long (int|float)
The total size of all assets in the domain.
- createdTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp that represents the date and time the domain was created.
- encryptionKey
-
- Type: string
The ARN of an Key Management Service (KMS) key associated with a domain.
- name
-
- Type: string
The name of the domain.
- owner
-
- Type: string
The Amazon Web Services account ID that owns the domain.
- repositoryCount
-
- Type: int
The number of repositories in the domain.
- s3BucketArn
-
- Type: string
The Amazon Resource Name (ARN) of the Amazon S3 bucket that is used to store package assets in the domain.
- status
-
- Type: string
The current status of a domain.
DomainEntryPoint
Description
Information about how a package originally entered the CodeArtifact domain. For packages published directly to CodeArtifact, the entry point is the repository it was published to. For packages ingested from an external repository, the entry point is the external connection that it was ingested from. An external connection is a CodeArtifact repository that is connected to an external repository such as the npm registry or NuGet gallery.
If a package version exists in a repository and is updated, for example if a package of the same version is added with additional assets, the package version's DomainEntryPoint
will not change from the original package version's value.
Members
- externalConnectionName
-
- Type: string
The name of the external connection that a package was ingested from.
- repositoryName
-
- Type: string
The name of the repository that a package was originally published to.
DomainSummary
Description
Information about a domain, including its name, Amazon Resource Name (ARN), and status. The ListDomains operation returns a list of DomainSummary
objects.
Members
- arn
-
- Type: string
The ARN of the domain.
- createdTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp that contains the date and time the domain was created.
- encryptionKey
-
- Type: string
The key used to encrypt the domain.
- name
-
- Type: string
The name of the domain.
- owner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- status
-
- Type: string
A string that contains the status of the domain.
InternalServerException
Description
The operation did not succeed because of an error that occurred inside CodeArtifact.
Members
- message
-
- Required: Yes
- Type: string
LicenseInfo
Description
Details of the license data.
Members
- name
-
- Type: string
Name of the license.
- url
-
- Type: string
The URL for license data.
PackageDependency
Description
Details about a package dependency.
Members
- dependencyType
-
- Type: string
The type of a package dependency. The possible values depend on the package type.
-
npm:
regular
,dev
,peer
,optional
-
maven:
optional
,parent
,compile
,runtime
,test
,system
,provided
.Note that
parent
is not a regular Maven dependency type; instead this is extracted from the<parent>
element if one is defined in the package version's POM file. -
nuget: The
dependencyType
field is never set for NuGet packages. -
pypi:
Requires-Dist
- namespace
-
- Type: string
The namespace of the package that this package depends on. The package component that specifies its namespace depends on its type. For example:
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- package
-
- Type: string
The name of the package that this package depends on.
- versionRequirement
-
- Type: string
The required version, or version range, of the package that this package depends on. The version format is specific to the package type. For example, the following are possible valid required versions:
1.2.3
,^2.3.4
, or4.x
.
PackageDescription
Description
Details about a package.
Members
- format
-
- Type: string
A format that specifies the type of the package.
- name
-
- Type: string
The name of the package.
- namespace
-
- Type: string
The namespace of the package. The package component that specifies its namespace depends on its type. For example:
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- originConfiguration
-
- Type: PackageOriginConfiguration structure
The package origin configuration for the package.
PackageGroupAllowedRepository
Description
Details about an allowed repository for a package group, including its name and origin configuration.
Members
- originRestrictionType
-
- Type: string
The origin configuration restriction type of the allowed repository.
- repositoryName
-
- Type: string
The name of the allowed repository.
PackageGroupDescription
Description
The description of the package group.
Members
- arn
-
- Type: string
The ARN of the package group.
- contactInfo
-
- Type: string
The contact information of the package group.
- createdTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp that represents the date and time the package group was created.
- description
-
- Type: string
The description of the package group.
- domainName
-
- Type: string
The name of the domain that contains the package group.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- originConfiguration
-
- Type: PackageGroupOriginConfiguration structure
The package group origin configuration that determines how package versions can enter repositories.
- parent
-
- Type: PackageGroupReference structure
The direct parent package group of the package group.
- pattern
-
- Type: string
The pattern of the package group. The pattern determines which packages are associated with the package group.
PackageGroupOriginConfiguration
Description
The package group origin configuration that determines how package versions can enter repositories.
Members
- restrictions
-
- Type: Associative array of custom strings keys (PackageGroupOriginRestrictionType) to PackageGroupOriginRestriction structures
The origin configuration settings that determine how package versions can enter repositories.
PackageGroupOriginRestriction
Description
Contains information about the configured restrictions of the origin controls of a package group.
Members
- effectiveMode
-
- Type: string
The effective package group origin restriction setting. If the value of
mode
isALLOW
,ALLOW_SPECIFIC_REPOSITORIES
, orBLOCK
, then the value ofeffectiveMode
is the same. Otherwise, when the value ofmode
isINHERIT
, then the value ofeffectiveMode
is the value ofmode
of the first parent group which does not have a value ofINHERIT
. - inheritedFrom
-
- Type: PackageGroupReference structure
The parent package group that the package group origin restrictions are inherited from.
- mode
-
- Type: string
The package group origin restriction setting. If the value of
mode
isALLOW
,ALLOW_SPECIFIC_REPOSITORIES
, orBLOCK
, then the value ofeffectiveMode
is the same. Otherwise, when the value isINHERIT
, then the value ofeffectiveMode
is the value ofmode
of the first parent group which does not have a value ofINHERIT
. - repositoriesCount
-
- Type: long (int|float)
The number of repositories in the allowed repository list.
PackageGroupReference
Description
Information about the identifiers of a package group.
Members
- arn
-
- Type: string
The ARN of the package group.
- pattern
-
- Type: string
The pattern of the package group. The pattern determines which packages are associated with the package group, and is also the identifier of the package group.
PackageGroupSummary
Description
Details about a package group.
Members
- arn
-
- Type: string
The ARN of the package group.
- contactInfo
-
- Type: string
The contact information of the package group.
- createdTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp that represents the date and time the repository was created.
- description
-
- Type: string
The description of the package group.
- domainName
-
- Type: string
The domain that contains the package group.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- originConfiguration
-
- Type: PackageGroupOriginConfiguration structure
Details about the package origin configuration of a package group.
- parent
-
- Type: PackageGroupReference structure
The direct parent package group of the package group.
- pattern
-
- Type: string
The pattern of the package group. The pattern determines which packages are associated with the package group.
PackageOriginConfiguration
Description
Details about the package origin configuration of a package.
Members
- restrictions
-
- Type: PackageOriginRestrictions structure
A
PackageOriginRestrictions
object that contains information about the upstream and publish package origin configuration for the package.
PackageOriginRestrictions
Description
Details about the origin restrictions set on the package. The package origin restrictions determine how new versions of a package can be added to a specific repository.
Members
- publish
-
- Required: Yes
- Type: string
The package origin configuration that determines if new versions of the package can be published directly to the repository.
- upstream
-
- Required: Yes
- Type: string
The package origin configuration that determines if new versions of the package can be added to the repository from an external connection or upstream source.
PackageSummary
Description
Details about a package, including its format, namespace, and name.
Members
- format
-
- Type: string
The format of the package.
- namespace
-
- Type: string
The namespace of the package. The package component that specifies its namespace depends on its type. For example:
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- originConfiguration
-
- Type: PackageOriginConfiguration structure
A PackageOriginConfiguration object that contains a PackageOriginRestrictions object that contains information about the upstream and publish package origin restrictions.
- package
-
- Type: string
The name of the package.
PackageVersionDescription
Description
Details about a package version.
Members
- displayName
-
- Type: string
The name of the package that is displayed. The
displayName
varies depending on the package version's format. For example, if an npm package is namedui
, is in the namespacevue
, and has the formatnpm
, then thedisplayName
is@vue/ui
. - format
-
- Type: string
The format of the package version.
- homePage
-
- Type: string
The homepage associated with the package.
- licenses
-
- Type: Array of LicenseInfo structures
Information about licenses associated with the package version.
- namespace
-
- Type: string
The namespace of the package version. The package component that specifies its namespace depends on its type. For example:
-
The namespace of a Maven package version is its
groupId
. -
The namespace of an npm or Swift package version is its
scope
. -
The namespace of a generic package is its
namespace
. -
Python, NuGet, Ruby, and Cargo package versions do not contain a corresponding component, package versions of those formats do not have a namespace.
- origin
-
- Type: PackageVersionOrigin structure
A PackageVersionOrigin object that contains information about how the package version was added to the repository.
- packageName
-
- Type: string
The name of the requested package.
- publishedTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp that contains the date and time the package version was published.
- revision
-
- Type: string
The revision of the package version.
- sourceCodeRepository
-
- Type: string
The repository for the source code in the package version, or the source code used to build it.
- status
-
- Type: string
A string that contains the status of the package version.
- summary
-
- Type: string
A summary of the package version. The summary is extracted from the package. The information in and detail level of the summary depends on the package version's format.
- version
-
- Type: string
The version of the package.
PackageVersionError
Description
l An error associated with package.
Members
- errorCode
-
- Type: string
The error code associated with the error. Valid error codes are:
-
ALREADY_EXISTS
-
MISMATCHED_REVISION
-
MISMATCHED_STATUS
-
NOT_ALLOWED
-
NOT_FOUND
-
SKIPPED
- errorMessage
-
- Type: string
The error message associated with the error.
PackageVersionOrigin
Description
Information about how a package version was added to a repository.
Members
- domainEntryPoint
-
- Type: DomainEntryPoint structure
A DomainEntryPoint object that contains information about from which repository or external connection the package version was added to the domain.
- originType
-
- Type: string
Describes how the package version was originally added to the domain. An
INTERNAL
origin type means the package version was published directly to a repository in the domain. AnEXTERNAL
origin type means the package version was ingested from an external connection.
PackageVersionSummary
Description
Details about a package version, including its status, version, and revision. The ListPackageVersions operation returns a list of PackageVersionSummary
objects.
Members
- origin
-
- Type: PackageVersionOrigin structure
A PackageVersionOrigin object that contains information about how the package version was added to the repository.
- revision
-
- Type: string
The revision associated with a package version.
- status
-
- Required: Yes
- Type: string
A string that contains the status of the package version. It can be one of the following:
- version
-
- Required: Yes
- Type: string
Information about a package version.
RepositoryDescription
Description
The details of a repository stored in CodeArtifact. A CodeArtifact repository contains a set of package versions, each of which maps to a set of assets. Repositories are polyglotâa single repository can contain packages of any supported type. Each repository exposes endpoints for fetching and publishing packages using tools like the npm
CLI, the Maven CLI (mvn
), and pip
. You can create up to 100 repositories per Amazon Web Services account.
Members
- administratorAccount
-
- Type: string
The 12-digit account number of the Amazon Web Services account that manages the repository.
- arn
-
- Type: string
The Amazon Resource Name (ARN) of the repository.
- createdTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp that represents the date and time the repository was created.
- description
-
- Type: string
A text description of the repository.
- domainName
-
- Type: string
The name of the domain that contains the repository.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain that contains the repository. It does not include dashes or spaces.
- externalConnections
-
- Type: Array of RepositoryExternalConnectionInfo structures
An array of external connections associated with the repository.
- name
-
- Type: string
The name of the repository.
- upstreams
-
- Type: Array of UpstreamRepositoryInfo structures
A list of upstream repositories to associate with the repository. The order of the upstream repositories in the list determines their priority order when CodeArtifact looks for a requested package version. For more information, see Working with upstream repositories.
RepositoryExternalConnectionInfo
Description
Contains information about the external connection of a repository.
Members
- externalConnectionName
-
- Type: string
The name of the external connection associated with a repository.
- packageFormat
-
- Type: string
The package format associated with a repository's external connection. The valid package formats are:
-
npm
: A Node Package Manager (npm) package. -
pypi
: A Python Package Index (PyPI) package. -
maven
: A Maven package that contains compiled code in a distributable format, such as a JAR file. -
nuget
: A NuGet package. -
generic
: A generic package. -
ruby
: A Ruby package. -
swift
: A Swift package. -
cargo
: A Cargo package.
- status
-
- Type: string
The status of the external connection of a repository. There is one valid value,
Available
.
RepositorySummary
Description
Details about a repository, including its Amazon Resource Name (ARN), description, and domain information. The ListRepositories operation returns a list of RepositorySummary
objects.
Members
- administratorAccount
-
- Type: string
The Amazon Web Services account ID that manages the repository.
- arn
-
- Type: string
The ARN of the repository.
- createdTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp that represents the date and time the repository was created.
- description
-
- Type: string
The description of the repository.
- domainName
-
- Type: string
The name of the domain that contains the repository.
- domainOwner
-
- Type: string
The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
- name
-
- Type: string
The name of the repository.
ResourceNotFoundException
Description
The operation did not succeed because the resource requested is not found in the service.
Members
- message
-
- Required: Yes
- Type: string
- resourceId
-
- Type: string
The ID of the resource.
- resourceType
-
- Type: string
The type of Amazon Web Services resource.
ResourcePolicy
Description
An CodeArtifact resource policy that contains a resource ARN, document details, and a revision.
Members
- document
-
- Type: string
The resource policy formatted in JSON.
- resourceArn
-
- Type: string
The ARN of the resource associated with the resource policy
- revision
-
- Type: string
The current revision of the resource policy.
ServiceQuotaExceededException
Description
The operation did not succeed because it would have exceeded a service limit for your account.
Members
- message
-
- Required: Yes
- Type: string
- resourceId
-
- Type: string
The ID of the resource.
- resourceType
-
- Type: string
The type of Amazon Web Services resource.
SuccessfulPackageVersionInfo
Description
Contains the revision and status of a package version.
Members
- revision
-
- Type: string
The revision of a package version.
- status
-
- Type: string
The status of a package version.
Tag
Description
A tag is a key-value pair that can be used to manage, search for, or filter resources in CodeArtifact.
Members
- key
-
- Required: Yes
- Type: string
The tag key.
- value
-
- Required: Yes
- Type: string
The tag value.
ThrottlingException
Description
The operation did not succeed because too many requests are sent to the service.
Members
- message
-
- Required: Yes
- Type: string
- retryAfterSeconds
-
- Type: int
The time period, in seconds, to wait before retrying the request.
UpstreamRepository
Description
Information about an upstream repository. A list of UpstreamRepository
objects is an input parameter to CreateRepository and UpdateRepository.
Members
- repositoryName
-
- Required: Yes
- Type: string
The name of an upstream repository.
UpstreamRepositoryInfo
Description
Information about an upstream repository.
Members
- repositoryName
-
- Type: string
The name of an upstream repository.
ValidationException
Description
The operation did not succeed because a parameter in the request was sent with an invalid value.
Members
- message
-
- Required: Yes
- Type: string
- reason
-
- Type: string