CodeArtifact exemples utilisant AWS CLI - Exemples de code de l'AWS SDK
Actions

D'autres AWS SDK exemples sont disponibles dans le GitHub dépôt AWS Doc SDK Examples.

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 montrent comment appeler des fonctions de service individuelles, vous pouvez les visualiser dans leur 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 API plus de détails, 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 API plus de détails, 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 API plus de détails, 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 API plus de détails, 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.

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 API plus de détails, 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 API plus de détails, 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 dépôt

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 API plus de détails, 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 de la version 4.0.0 du package de test 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.

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 URL terminaison 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.

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 API plus de détails, 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 de la version du package et les dépendances 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 API plus de détails, 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 des packages dans le guide de AWS CodeArtifact l'utilisateur.

  • Pour API plus de détails, 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 API plus de détails, 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 in the AWS CodeArtifact User Guide.

  • Pour API plus de détails, consultez la section Référence de connexion aux AWS CLI commandes.

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, consultez la section 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 API plus de détails, voir UpdateRepositoryla section Référence des AWS CLI commandes.