CodeArtifact exemples utilisant AWS CLI - AWS Command Line Interface
Actions

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

CodeArtifact exemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with 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 façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliserassociate-external-connection.

AWS CLI

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

L'associate-external-connectionexemple 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, voir Ajouter une connexion externe dans le guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utilisercopy-package-versions.

AWS CLI

Pour copier des versions de packages d'un référentiel à un autre

Ce qui suit copy-package-versions déplace 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, voir Copier des packages entre des référentiels dans le Guide de l'AWS CodeArtifact utilisateur.

  • Pour plus de détails sur l'API, voir CopyPackageVersionsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-domain.

AWS CLI

Pour créer un domaine

L'create-domainexemple 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 la section Création d'un domaine dans le guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir CreateDomainla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-repository.

AWS CLI

Pour créer un référentiel

L'create-repositoryexemple suivant crée un dépôt 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 la section Création d'un domaine dans le guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir CreateRepositoryla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-domain-permissions-policy.

AWS CLI

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

L'delete-domain-permissions-policyexemple 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, voir Supprimer une politique de domaine dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserdelete-domain.

AWS CLI

Pour supprimer un domaine

L'delete-domainexemple 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, voir Supprimer un domaine dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir DeleteDomainla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-package-versions.

AWS CLI

Pour supprimer des versions de package

L'delete-package-versionsexemple 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, voir Supprimer une version de package dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir DeletePackageVersionsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-repository-permissions-policy.

AWS CLI

Pour supprimer une politique d'autorisation d'un référentiel

L'delete-repository-permissions-policyexemple suivant supprime la politique d'autorisation 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, voir Supprimer une politique dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserdelete-repository.

AWS CLI

Pour supprimer un référentiel

L'delete-repositoryexemple 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, voir Supprimer un référentiel dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir DeleteRepositoryla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-domain.

AWS CLI

Pour obtenir des informations sur un domaine

L'describe-domainexemple suivant renvoie un DomainDescription objet 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 la section Présentation du domaine dans le guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir DescribeDomainla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-repository.

AWS CLI

Pour obtenir des informations sur un référentiel

L'describe-repositoryexemple suivant renvoie un RepositoryDescription objet 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 la section Création d'un domaine dans le guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir DescribeRepositoryla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdisassociate-external-connection.

AWS CLI

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

L'disassociate-external-connectionexemple suivant supprime une connexion externe à npmjs.com depuis un dépôt 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, voir Supprimer une connexion externe dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserdispose-package-versions.

AWS CLI

Pour supprimer les actifs d'une version de package et définir son statut sur Disposé

L'dispose-package-versionsexemple suivant supprime les actifs du package de test version 4.0.0 et définit son statut sur Disposed.

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 la section Utilisation des packages CodeArtifact dans le guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserget-authorization-token.

AWS CLI

Pour obtenir un jeton d'autorisation

L'get-authorization-tokenexemple suivant récupère un jeton CodeArtifact d'autorisation.

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, voir Configurer pip sans la commande de connexion dans le Guide de l'AWS CodeArtifact utilisateur.

  • Pour plus de détails sur l'API, voir GetAuthorizationTokenla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-domain-permissions-policy.

AWS CLI

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

L'get-domain-permissions-policyexemple suivant montre comment associer la politique d'autorisation à 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 la section Lire une politique de domaine dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserget-package-version-asset.

AWS CLI

Pour obtenir un actif à partir d'une version de package

L'get-package-version-assetexemple suivant récupère l'package.tgzactif 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, voir Répertorier les actifs des versions du package dans le guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserget-package-version-readme.

AWS CLI

Pour obtenir le fichier readme d'une version de package

L'get-package-version-readmeexemple 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, voir Afficher le fichier readme de la version du package dans le guide de l'AWS CodeArtifact utilisateur.

L'exemple de code suivant montre comment utiliserget-repository-endpoint.

AWS CLI

Pour obtenir le point de terminaison URL d'un dépôt

L'get-repository-endpointexemple 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, voir Se connecter à un référentiel dans le guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir GetRepositoryEndpointla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-repository-permissions-policy.

AWS CLI

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

L'get-repository-permissions-policyexemple suivant montre comment associer la politique d'autorisation à 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, voir Lire une politique dans le guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserlist-domains.

AWS CLI

Pour répertorier des domaines

L'list-domainsexemple suivant renvoie un résumé de tous les domaines détenus par le AWS compte 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 la section Utilisation des domaines CodeArtifact dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir ListDomainsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-package-version-assets.

AWS CLI

Pour afficher les ressources d'une version de package

L'list-package-version-assetsexemple 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, voir Répertorier les actifs des versions du package dans le guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserlist-package-version-dependencies.

AWS CLI

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

L'list-package-version-dependenciesexemple suivant récupère les dépendances pour 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, voir Afficher et mettre à jour les détails et les dépendances des versions du package dans le guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserlist-package-versions.

AWS CLI

Pour répertorier les versions d'un package

L'list-package-versionsexemple 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, voir Répertorier les versions des packages dans le guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir ListPackageVersionsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-packages.

AWS CLI

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

L'list-packagesexemple 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, voir Répertorier les noms de packages dans le guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir ListPackagesla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-repositories-in-domain.

AWS CLI

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

L'list-repositories-in-domainexemple suivant renvoie un résumé de tous les référentiels du domaine de test.

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, voir Répertorier les référentiels dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserlist-repositories.

AWS CLI

Pour répertorier les référentiels

L'list-repositoriesexemple suivant renvoie un résumé de tous les référentiels du domaine appartenant au AWS compte 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, voir Répertorier les référentiels dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir ListRepositoriesla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlogin.

AWS CLI

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

L'loginexemple 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 la section Getting started with the AWS CLI dans le guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserput-domain-permissions-policy.

AWS CLI

Pour associer une politique d'autorisation à un domaine

L'put-domain-permissions-policyexemple suivant attache une politique d'autorisation 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, voir Définir une politique de domaine dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserput-repository-permissions-policy.

AWS CLI

Pour associer une politique d'autorisation à un référentiel

L'put-repository-permissions-policyexemple suivant joint une politique d'autorisation 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, voir Définir une politique dans le guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserupdate-package-versions-status.

AWS CLI

Pour mettre à jour l'état de la version du package

L'update-package-versions-statusexemple suivant met à jour le statut de la version 4.0.0 du package de test sur Archivé.

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 la section État de la version du package de mise à jour dans le guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserupdate-repository.

AWS CLI

Pour mettre à jour un référentiel

L'update-repositoryexemple suivant met à jour la description d'un dépôt nommé test-repo dans un domaine nommé test-domain en « 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, voir Afficher ou modifier une configuration de référentiel dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, voir UpdateRepositoryla section Référence des AWS CLI commandes.