Exemples d’utilisation de l’AWS CLI avec CodeArtifact - AWS Command Line Interface

Cette documentation concerne uniquement la version 1 de l’AWS CLI. Pour la documentation relative à la version 2 de l’AWS CLI, consultez le Guide de l’utilisateur de la version 2.

Exemples d’utilisation de l’AWS CLI avec CodeArtifact

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec CodeArtifact.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser associate-external-connection.

AWS CLI

Pour ajouter une connexion externe à un référentiel

L’exemple associate-external-connection suivant ajoute une connexion externe à npmjs.com à un référentiel nommé test-repo.

aws codeartifact associate-external-connection \ --repository test-repo \ --domain test-domain \ --external-connection public:npmjs

Sortie :

{ "repository": { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "upstreams": [], "externalConnections": [ { "externalConnectionName": "public:npmjs", "packageFormat": "npm", "status": "AVAILABLE" } ] } }

Pour plus d’informations, consultez Ajouter une connexion externe dans le Guide de l’utilisateur AWS CodeArtifact.

L’exemple de code suivant montre comment utiliser copy-package-versions.

AWS CLI

Pour copier des versions de package d’un référentiel vers un autre

Les commandes copy-package-versions suivantes déplacent les versions 4.0.0 et 5.0.0 d’un package nommé test-package de my-repo vers test-repo.

aws codeartifact copy-package-versions \ --domain test-domain \ --source-repository my-repo \ --destination-repository test-repo \ --format npm \ --package test-package \ --versions '["4.0.0", "5.0.0"]'

Sortie :

{ "format": "npm", "package": "test-package", "versions": [ { "version": "5.0.0", "revision": "REVISION-1-SAMPLE-6C81EFF7DA55CC", "status": "Published" }, { "version": "4.0.0", "revision": "REVISION-2-SAMPLE-55C752BEE772FC", "status": "Published" } ] }

Pour plus d’informations, consultez Copie de packages entre des référentiels dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez CopyPackageVersions dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-domain.

AWS CLI

Pour créer un domaine

L’exemple create-domain suivant crée un domaine nommé test-domain.

aws codeartifact create-domain \ --domain test-domain

Sortie :

{ "domain": { "name": "test-domain", "owner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/test-domain", "status": "Active", "createdTime": "2020-10-20T13:16:48.559000-04:00", "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "repositoryCount": 0, "assetSizeBytes": 0 } }

Pour plus d’informations, consultez Création d’un domaine dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez CreateDomain dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-repository.

AWS CLI

Pour créer un référentiel

L’exemple create-repository suivant crée un référentiel nommé test-repo dans un domaine nommé test-domain.

aws codeartifact create-repository \ --domain test-domain \ --domain-owner 111122223333 \ --repository test-repo \ --description "This is a test repository."

Sortie :

{ "repository": { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "description": "This is a test repository.", "upstreams": [], "externalConnections": [] } }

Pour plus d’informations, consultez Création d’un domaine dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez CreateRepository dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-domain-permissions-policy.

AWS CLI

Pour supprimer le document de politique d’autorisations d’un domaine

L’exemple delete-domain-permissions-policy suivant supprime la politique d’autorisation d’un domaine nommé test-domain.

aws codeartifact delete-domain-permissions-policy \ --domain test-domain

Sortie :

{ "Version":"2012-10-17", "Statement": [ { "Sid": "BasicDomainPolicy", "Action": [ "codeartifact:GetDomainPermissionsPolicy", "codeartifact:ListRepositoriesInDomain", "codeartifact:GetAuthorizationToken", "codeartifact:CreateRepository" ], "Effect": "Allow", "Resource": "*", "Principal": { "AWS": "arn:aws:iam::111122223333:root" } } ] }

Pour plus d’informations, consultez Suppression d’une politique de domaine dans le Guide de l’utilisateur AWS CodeArtifact.

L’exemple de code suivant montre comment utiliser delete-domain.

AWS CLI

Pour supprimer un domaine

L’exemple delete-domain suivant supprime un domaine nommé test-domain.

aws codeartifact delete-domain \ --domain test-domain

Sortie :

{ "domain": { "name": "test-domain", "owner": "417498243647", "arn": "arn:aws:codeartifact:us-west-2:417498243647:domain/test-domain", "status": "Deleted", "createdTime": "2020-10-20T13:16:48.559000-04:00", "encryptionKey": "arn:aws:kms:us-west-2:417498243647:key/c9fe2447-0795-4fda-afbe-8464574ae162", "repositoryCount": 0, "assetSizeBytes": 0 } }

Pour plus d’informations, consultez Supprimer un domaine dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez DeleteDomain dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-package-versions.

AWS CLI

Pour supprimer des versions de package

L’exemple delete-package-versions suivant supprime la version 4.0.0 d’un package nommé test-package.

aws codeartifact delete-package-versions \ --domain test-domain \ --repo test-repo \ --format npm \ --package test-package \ --versions 4.0.0

Sortie :

{ "successfulVersions": { "4.0.0": { "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=", "status": "Deleted" } }, "failedVersions": {} }

Pour plus d’informations, consultez Suppression d’une version de package dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez DeletePackageVersions dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-repository-permissions-policy.

AWS CLI

Pour supprimer une politique d’autorisations d’un référentiel

L’exemple delete-repository-permissions-policy suivant supprime la politique d’autorisations d’un référentiel nommé test-repo.

aws codeartifact delete-repository-permissions-policy \ --domain test-domain \ --repository test-repo

Sortie :

{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:root" }, "Action": [ "codeartifact:DescribePackageVersion", "codeartifact:DescribeRepository", "codeartifact:GetPackageVersionReadme", "codeartifact:GetRepositoryEndpoint", "codeartifact:ListPackages", "codeartifact:ListPackageVersions", "codeartifact:ListPackageVersionAssets", "codeartifact:ListPackageVersionDependencies", "codeartifact:ReadFromRepository" ], "Resource": "*" } ] }

Pour plus d’informations, consultez Supprimer une politique dans le Guide de l’utilisateur AWS CodeArtifact.

L’exemple de code suivant montre comment utiliser delete-repository.

AWS CLI

Pour supprimer un référentiel

L’exemple delete-repository suivant supprime un référentiel nommé test-repo dans un domaine nommé test-domain.

aws codeartifact delete-repository \ --domain test-domain \ --repository test-repo

Sortie :

{ "repository": { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "description": "This is a test repository", "upstreams": [], "externalConnections": [] } }

Pour plus d’informations, consultez Delete a repository dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez DeleteRepository dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-domain.

AWS CLI

Pour obtenir les informations sur un domaine

L’exemple describe-domain suivant renvoie un objet DomainDescription pour un domaine nommé test-domain.

aws codeartifact describe-domain \ --domain test-domain

Sortie :

{ "domain": { "name": "test-domain", "owner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/test-domain", "status": "Active", "createdTime": "2020-10-20T13:16:48.559000-04:00", "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "repositoryCount": 2, "assetSizeBytes": 0, "s3BucketArn": "arn:aws:s3:::assets-111122223333-us-west-2" } }

Pour plus d’informations, consultez Présentation des domaines dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez DescribeDomain dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-repository.

AWS CLI

Pour obtenir les informations sur un référentiel

L’exemple describe-repository suivant renvoie un objet RepositoryDescription pour un référentiel nommé test-repo.

aws codeartifact describe-repository \ --domain test-domain \ --repository test-repo

Sortie :

{ "repository": { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "description": "This is a test repository.", "upstreams": [], "externalConnections": [] } }

Pour plus d’informations, consultez Création d’un domaine dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez DescribeRepository dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser disassociate-external-connection.

AWS CLI

Pour supprimer une connexion externe d’un référentiel

L’exemple disassociate-external-connection suivant supprime une connexion externe à npmjs.com d’un référentiel nommé test-repo.

aws codeartifact disassociate-external-connection \ --repository test-repo \ --domain test-domain \ --external-connection public:npmjs

Sortie :

{ "repository": { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "upstreams": [], "externalConnections": [] } }

Pour plus d’informations, consultez Suppression d’une connexion externe dans le Guide de l’utilisateur AWS CodeArtifact.

L’exemple de code suivant montre comment utiliser dispose-package-versions.

AWS CLI

Pour supprimer les actifs d’une version de package et définir son statut sur Éliminé

L’exemple dispose-package-versions suivant supprime les actifs de la version 4.0.0 du package de test et définit son statut sur Éliminé.

aws codeartifact dispose-package-versions \ --domain test-domain \ --repo test-repo \ --format npm \ --package test-package \ --versions 4.0.0

Sortie :

{ "successfulVersions": { "4.0.0": { "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=", "status": "Disposed" } }, "failedVersions": {} }

Pour plus d’informations, consultez Working with packages in CodeArtifact dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez DisposePackageVersions dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-authorization-token.

AWS CLI

Pour obtenir un jeton d’autorisation

L’exemple get-authorization-token suivant récupère un jeton d’autorisation CodeArtifact.

aws codeartifact get-authorization-token \ --domain test-domain \ --query authorizationToken \ --output text

Sortie :

This command will return the authorization token. You can store the output in an environment variable when calling the command.

Pour plus d’informations, consultez Configuration de pip sans la commande de connexion dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez GetAuthorizationToken dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-domain-permissions-policy.

AWS CLI

Pour obtenir le document de politique d’autorisations pour un domaine

L’exemple get-domain-permissions-policy suivant obtient la politique d’autorisations attachée à un domaine nommé test-domain.

aws codeartifact get-domain-permissions-policy \ --domain test-domain

Sortie :

{ "Version":"2012-10-17", "Statement": [ { "Sid": "BasicDomainPolicy", "Action": [ "codeartifact:GetDomainPermissionsPolicy", "codeartifact:ListRepositoriesInDomain", "codeartifact:GetAuthorizationToken", "codeartifact:CreateRepository" ], "Effect": "Allow", "Resource": "*", "Principal": { "AWS": "arn:aws:iam::111122223333:root" } } ] }

Pour plus d’informations, consultez Lecture d’une politique de domaine dans le Guide de l’utilisateur AWS CodeArtifact.

L’exemple de code suivant montre comment utiliser get-package-version-asset.

AWS CLI

Pour obtenir une ressource d’une version de package

L’exemple get-package-version-asset suivant récupère l’actif package.tgz pour la version 4.0.0 d’un package npm nommé test-package.

aws codeartifact get-package-version-asset \ --domain test-domain \ --repository test-repo \ --format npm \ --package test-package \ --package-version 4.0.0 \ --asset 'package.tgz' \ outfileName

Sortie :

The output for this command will also store the raw asset in the file provided in place of outfileName. { "assetName": "package.tgz", "packageVersion": "4.0.0", "packageVersionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=" }

Pour plus d’informations, consultez List package version assets dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez GetPackageVersionAsset dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-package-version-readme.

AWS CLI

Pour obtenir le fichier readme d’une version de package

L’exemple get-package-version-readme suivant récupère le fichier readme pour la version 4.0.0 d’un package npm nommé test-package.

aws codeartifact get-package-version-readme \ --domain test-domain \ --repo test-repo \ --format npm \ --package test-package \ --package-version 4.0.0

Sortie :

{ "format": "npm", "package": "test-package", "version": "4.0.0", "readme": "<div align=\"center\">\n <a href=\https://github.com/test-package/testpack\"> ... more content ... \n", "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=" }

Pour plus d’informations, consultez View package version readme file dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez GetPackageVersionReadme dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-repository-endpoint.

AWS CLI

Pour obtenir le point de terminaison d’URL d’un référentiel

L’exemple get-repository-endpoint suivant renvoie le point de terminaison npm pour le référentiel test-repo.

aws codeartifact get-repository-endpoint \ --domain test-domain \ --repository test-repo \ --format npm

Sortie :

{ "repositoryEndpoint": "https://test-domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/npm/test-repo/" }

Pour plus d’informations, consultez Connect to a repository dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez GetRepositoryEndpoint dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-repository-permissions-policy.

AWS CLI

Pour obtenir le document de politique d’autorisations pour un référentiel

L’exemple get-repository-permissions-policy suivant obtient la politique d’autorisations attachée à un référentiel nommé test-repo.

aws codeartifact get-repository-permissions-policy \ --domain test-domain \ --repository test-repo

Sortie :

{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:root" }, "Action": [ "codeartifact:DescribePackageVersion", "codeartifact:DescribeRepository", "codeartifact:GetPackageVersionReadme", "codeartifact:GetRepositoryEndpoint", "codeartifact:ListPackages", "codeartifact:ListPackageVersions", "codeartifact:ListPackageVersionAssets", "codeartifact:ListPackageVersionDependencies", "codeartifact:ReadFromRepository" ], "Resource": "*" } ] }

Pour plus d’informations, consultez Read a policy dans le Guide de l’utilisateur AWS CodeArtifact.

L’exemple de code suivant montre comment utiliser list-domains.

AWS CLI

Pour répertorier les domaines

L’exemple list-domains suivant renvoie un récapitulatif de tous les domaines appartenant au compte AWS qui effectue l’appel.

aws codeartifact list-domains

Sortie :

{ "domains": [ { "name": "my-domain", "owner": "111122223333", "status": "Active", "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }, { "name": "test-domain", "owner": "111122223333", "status": "Active", "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ] }

Pour plus d’informations, consultez Utilisation des domaines dans CodeArtifact dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez ListDomains dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-package-version-assets.

AWS CLI

Pour afficher les actifs d’une version de package

L’exemple list-package-version-assets suivant récupère les actifs de la version 4.0.0 d’un package npm nommé test-package.

aws codeartifact list-package-version-assets \ --domain test-domain \ --repo test-repo \ --format npm \ --package test-package \ --package-version 4.0.0

Sortie :

{ "format": "npm", "package": "test-package", "version": "4.0.0", "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=", "assets": [ { "name": "package.tgz", "size": 316680, "hashes": { "MD5": "60078ec6d9e76b89fb55c860832742b2", "SHA-1": "b44a9b6297bcb698f1c51a3545a2b3b368d59c52", "SHA-256": "d2aa8c6afc3c8591765785a37d1c5acae482a8eb3ab9729ed28922692454f2e2", "SHA-512": "3e585d15c8a594e20d7de57b362ea81754c011acb2641a19f1b72c8531ea39825896bab344ae616a0a5a824cb9a381df0b3cddd534645cf305aba70a93dac698" } } ] }

Pour plus d’informations, consultez List package version assets dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez ListPackageVersionAssets dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-package-version-dependencies.

AWS CLI

Pour afficher les dépendances d’une version de package

L’exemple list-package-version-dependencies suivant récupère les dépendances de la version 4.0.0 d’un package npm nommé test-package.

aws codeartifact list-package-version-dependencies \ --domain test-domain \ --repo test-repo \ --format npm \ --package test-package \ --package-version 4.0.0

Sortie :

{ "format": "npm", "package": "test-package", "version": "4.0.0", "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=", "dependencies": [ { "namespace": "testns", "package": "testdep1", "dependencyType": "regular", "versionRequirement": "1.8.5" }, { "namespace": "testns", "package": "testdep2", "dependencyType": "regular", "versionRequirement": "1.8.5" } ] }

Pour plus d’informations, consultez View and update package version details and dependencies dans le Guide de l’utilisateur AWS CodeArtifact.

L’exemple de code suivant montre comment utiliser list-package-versions.

AWS CLI

Pour répertorier les versions d’un package

L’exemple list-package-versions suivant renvoie une liste des versions de package pour un package nommé kind-of.

aws codeartifact list-package-versions \ --package kind-of \ --domain test-domain \ --repository test-repo \ --format npm

Sortie :

{ "defaultDisplayVersion": "1.0.1", "format": "npm", "package": "kind-of", "versions": [ { "version": "1.0.1", "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC", "status": "Published" }, { "version": "1.0.0", "revision": "REVISION-SAMPLE-2-C752BEEF6D2CFC", "status": "Published" }, { "version": "0.1.2", "revision": "REVISION-SAMPLE-3-654S65A5C5E1FC", "status": "Published" }, { "version": "0.1.1", "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"", "status": "Published" }, { "version": "0.1.0", "revision": "REVISION-SAMPLE-4-AF669139B772FC", "status": "Published" } ] }

Pour plus d’informations, consultez Liste des versions de packages dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez ListPackageVersions dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-packages.

AWS CLI

Pour répertorier les packages dans un référentiel

L’exemple list-packages suivant répertorie les packages d’un référentiel nommé test-repo dans un domaine nommé test-domain.

aws codeartifact list-packages \ --domain test-domain \ --repository test-repo

Sortie :

{ "packages": [ { "format": "npm", "package": "lodash" } { "format": "python", "package": "test-package" } ] }

Pour plus d’informations, consultez Liste des noms de packages dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez ListPackages dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-repositories-in-domain.

AWS CLI

Pour répertorier les référentiels d’un domaine

L’exemple list-repositories-in-domain suivant renvoie un récapitulatif de tous les référentiels du domaine test-domain.

aws codeartifact list-repositories-in-domain \ --domain test-domain

Sortie :

{ "repositories": [ { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "description": "This is a test repository." }, { "name": "test-repo2", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo2", "description": "This is a test repository." } ] }

Pour plus d’informations, consultez List repositories dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez ListRepositoriesInDomain dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-repositories.

AWS CLI

Pour répertorier les référentiels

L’exemple list-repositories suivant renvoie un récapitulatif de tous les référentiels du domaine appartenant au compte AWS qui effectue l’appel.

aws codeartifact list-repositories

Sortie :

{ "repositories": [ { "name": "npm-store", "administratorAccount": "111122223333", "domainName": "my-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store", "description": "Provides npm artifacts from npm, Inc." }, { "name": "target-repo", "administratorAccount": "111122223333", "domainName": "my-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/target-repo", "description": "test target repo" }, { "name": "test-repo2", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo2", "description": "This is a test repository." } ] }

Pour plus d’informations, consultez List repositories dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez ListRepositories dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser login.

AWS CLI

Pour configurer l’authentification auprès de votre référentiel à l’aide de la commande de connexion

L’exemple login suivant configure le gestionnaire de packages npm avec un référentiel nommé test-repo dans un domaine nommé test-domain.

aws codeartifact login \ --domain test-domain \ --repository test-repo \ --tool npm

Sortie :

Successfully configured npm to use AWS CodeArtifact repository https://test-domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/npm/test-repo/ Login expires in 12 hours at 2020-11-12 01:53:16-05:00

Pour plus d’informations, consultez Getting started with the AWS CLI dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez Login dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser put-domain-permissions-policy.

AWS CLI

Pour attacher une politique d’autorisations à un domaine

L’exemple put-domain-permissions-policy suivant attache une politique d’autorisations définie dans le fichier policy.json à un domaine nommé test-domain.

aws codeartifact put-domain-permissions-policy \ --domain test-domain \ --policy-document file://PATH/TO/policy.json

Sortie :

{ "policy": { "resourceArn": "arn:aws:codeartifact:region-id:111122223333:domain/test-domain", "document": "{ ...policy document content...}", "revision": "MQlyyTQRASRU3HB58gBtSDHXG7Q3hvxxxxxxx=" } }

Pour plus d’informations, consultez Définition d’une politique de domaine dans le Guide de l’utilisateur AWS CodeArtifact.

L’exemple de code suivant montre comment utiliser put-repository-permissions-policy.

AWS CLI

Pour attacher une politique d’autorisations à un référentiel

L’exemple put-repository-permissions-policy suivant attache une politique d’autorisations définie dans le fichier policy.json à un référentiel nommé test-repo.

aws codeartifact put-repository-permissions-policy \ --domain test-domain \ --repository test-repo \ --policy-document file://PATH/TO/policy.json

Sortie :

{ "policy": { "resourceArn": "arn:aws:codeartifact:region-id:111122223333:repository/test-domain/test-repo", "document": "{ ...policy document content...}", "revision": "MQlyyTQRASRU3HB58gBtSDHXG7Q3hvxxxxxxx=" } }

Pour plus d’informations, consultez Set a policy dans le Guide de l’utilisateur AWS CodeArtifact.

L’exemple de code suivant montre comment utiliser update-package-versions-status.

AWS CLI

Pour mettre à jour le statut de la version du package

L’exemple update-package-versions-status suivant met à jour le statut de la version 4.0.0 du package test-package sur Archivée.

aws codeartifact update-package-versions-status \ --domain test-domain \ --repo test-repo \ --format npm \ --package test-package \ --versions 4.0.0 \ --target-status Archived

Sortie :

{ "successfulVersions": { "4.0.0": { "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=", "status": "Archived" } }, "failedVersions": {} }

Pour plus d’informations, consultez Mise à jour de l’état de la version du package dans le Guide de l’utilisateur AWS CodeArtifact.

L’exemple de code suivant montre comment utiliser update-repository.

AWS CLI

Pour mettre à jour un référentiel

L’exemple update-repository suivant met à jour la description d’un référentiel nommé test-repo dans un domaine nommé test-domain en la remplaçant par « ceci est une description mise à jour ».

aws codeartifact update-repository \ --domain test-domain \ --repository test-repo \ --description "this is an updated description"

Sortie :

{ "repository": { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "description": "this is an updated description", "upstreams": [], "externalConnections": [] } }

Pour plus d’informations, consultez View or modify a repository configuration dans le Guide de l’utilisateur AWS CodeArtifact.

  • Pour plus de détails sur l’API, consultez UpdateRepository dans la Référence des commandes de l’AWS CLI.