Exemplos do CodeArtifact usando a AWS CLI - AWS Command Line Interface
Ações

Exemplos do CodeArtifact usando a AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando a AWS Command Line Interface com o CodeArtifact.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar associate-external-connection.

AWS CLI

Para adicionar uma conexão externa a um repositório

O exemplo associate-external-connection a seguir adiciona uma conexão externa ao npmjs.com a um repositório chamado test-repo.

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

Saída:

{
    "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"
            }
        ]
    }
}

Para obter mais informações, consulte Adicionar uma conexão externa no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar copy-package-versions.

AWS CLI

Como copiar versões de pacote de um repositório para outro

O copy-package-versions seguinte move as versões 4.0.0 e 5.0.0 de um pacote chamado test-package de my-repo para 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"]'

Saída:

{
    "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"
        }
    ]
}

Para obter mais informações, consulte Copiar pacotes entre repositórios no Guia do usuário do AWS CodeArtifact.

  • Para obter os detalhes da API, consulte CopyPackageVersions na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar create-domain.

AWS CLI

Para criar um domínio

O exemplo create-domain a seguir cria um domínio chamado test-domain.

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

Saída:

{
    "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
    }
}

Para obter mais informações, consulte Criar um domínio no Guia do usuário do AWS CodeArtifact.

  • Para ver detalhes da API, consulte CreateDomain na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar create-repository.

AWS CLI

Para criar um repositório

O exemplo create-repository a seguir cria um repositório chamado test-repo dentro de um domínio chamado test-domain.

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

Saída:

{
    "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": []
    }
}

Para obter mais informações, consulte Criar um domínio no Guia do usuário do AWS CodeArtifact.

  • Para ver detalhes da API, consulte CreateRepository na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar delete-domain-permissions-policy.

AWS CLI

Para excluir o documento de política de permissões de um domínio

O exemplo delete-domain-permissions-policy a seguir exclui a política de permissão de um domínio chamado test-domain.

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

Saída:

{
    "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"
            }
        }
    ]
}

Para obter mais informações, consulte Excluir uma política de domínio no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar delete-domain.

AWS CLI

Para excluir um domínio

O exemplo delete-domain a seguir exclui um domínio chamado test-domain.

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

Saída:

{
    "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
    }
}

Para obter mais informações, consulte Excluir um domínio no Guia do usuário do AWS CodeArtifact.

  • Para ver detalhes da API, consulte DeleteDomain na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar delete-package-versions.

AWS CLI

Para excluir versões de pacote

O exemplo delete-package-versions a seguir exclui a versão 4.0.0 de um pacote chamado test-package.

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

Saída:

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

Para obter mais informações, consulte Excluir uma versão de pacote no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar delete-repository-permissions-policy.

AWS CLI

Para excluir uma política de permissões de um repositório

O exemplo delete-repository-permissions-policy a seguir exclui a política de permissão de um repositório chamado test-repo.

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

Saída:

{
    "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": "*"
        }
    ]
}

Para obter mais informações, consulte Excluir uma política no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar delete-repository.

AWS CLI

Para excluir um repositório

O exemplo delete-repository a seguir exclui um repositório chamado test-repo em um domínio chamado test-domain.

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

Saída:

{
    "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": []
    }
}

Para obter mais informações, consulte Excluir um repositório no Guia do usuário do AWS CodeArtifact.

  • Para ver detalhes da API, consulte DeleteRepository na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar describe-domain.

AWS CLI

Para obter informações sobre um domínio

O exemplo describe-domain a seguir retorna um objeto DomainDescription para um domínio chamado test-domain.

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

Saída:

{
    "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"
    }
}

Para obter mais informações, consulte Visão geral do domínio no Guia do Usuário do AWS CodeArtifact.

  • Para ver detalhes da API, consulte DescribeDomain na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar describe-repository.

AWS CLI

Para obter informações sobre um repositório

O exemplo describe-repository a seguir retorna um objeto RepositoryDescription para um repositório chamado test-repo.

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

Saída:

{
    "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": []
    }
}

Para obter mais informações, consulte Criar um domínio no Guia do usuário do AWS CodeArtifact.

  • Para ver detalhes da API, consulte DescribeRepository na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar disassociate-external-connection.

AWS CLI

Para remover uma conexão externa de um repositório

O exemplo disassociate-external-connection a seguir remove uma conexão externa com npmjs.com de um repositório chamado test-repo.

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

Saída:

{
    "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": []
    }
}

Para obter mais informações, consulte Remover uma conexão externa no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar dispose-package-versions.

AWS CLI

Para excluir os ativos de uma versão do pacote e definir seu status como Descartado

O exemplo dispose-package-versions a seguir exclui os ativos do pacote de teste versão 4.0.0 e define seu status como Descartado.

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

Saída:

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

Para obter mais informações, consulte Trabalhar com pacotes no CodeArtifact no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar get-authorization-token.

AWS CLI

Para obter um token de autorização

O exemplo get-authorization-token a seguir recupera um token de autorização do CodeArtifact.

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

Saída:

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

Para obter mais informações, consulte Configurar o pip sem o comando de login no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar get-domain-permissions-policy.

AWS CLI

Para obter o documento de política de permissões de um domínio

O exemplo get-domain-permissions-policy a seguir anexa a política de permissão a um domínio chamado test-domain.

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

Saída:

{
    "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"
            }
        }
    ]
}

Para obter mais informações, consulte Ler uma política de domínio no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar get-package-version-asset.

AWS CLI

Para obter um ativo de uma versão do pacote

O exemplo get-package-version-asset a seguir recupera o ativo package.tgz para a versão 4.0.0 de um pacote npm chamado 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

Saída:

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="
}

Para obter mais informações, consulte Listar ativos da versão do pacote no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar get-package-version-readme.

AWS CLI

Para obter o arquivo readme de uma versão de pacote

O exemplo get-package-version-readme a seguir recupera o arquivo readme da versão 4.0.0 de um pacote npm chamado test-package.

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

Saída:

{
    "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="
}

Para obter mais informações, consulte Exibir arquivo readme da versão do pacote no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar get-repository-endpoint.

AWS CLI

Para obter o endpoint de URL de um repositório

O exemplo get-repository-endpoint a seguir retorna o endpoint npm para o repositório test-repo.

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

Saída:

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

Para obter mais informações, consulte Conectar-se a um repositório no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar get-repository-permissions-policy.

AWS CLI

Para obter o documento de política de permissões de um repositório

O exemplo get-repository-permissions-policy a seguir anexa a política de permissão a um repositório chamado test-repo.

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

Saída:

{
    "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": "*"
        }
    ]
}

Para obter mais informações, consulte Ler uma política no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar list-domains.

AWS CLI

Para listar domínios

O exemplo list-domains a seguir retorna um resumo de todos os domínios pertencentes à conta da AWS que faz a chamada.

aws codeartifact list-domains

Saída:

{
    "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"
        }
    ]
}

Para obter mais informações, consulte Trabalhar com domínios no CodeArtifact no Guia do usuário do AWS CodeArtifact.

  • Para ver detalhes da API, consulte ListDomains na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar list-package-version-assets.

AWS CLI

Como visualizar os ativos de uma versão do pacote

O exemplo list-package-version-assets a seguir recupera os ativos para a versão 4.0.0 de um pacote npm chamado test-package.

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

Saída:

{
    "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"
            }
        }
    ]
}

Para obter mais informações, consulte Listar ativos da versão do pacote no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar list-package-version-dependencies.

AWS CLI

Como exibir dependências de versão de pacote

O exemplo list-package-version-dependencies a seguir recupera as dependências para a versão 4.0.0 de um pacote npm chamado test-package.

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

Saída:

{
    "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"
        }
    ]
}

Para obter mais informações, consulte Exibir e atualizar os detalhes e dependências da versão do pacote no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar list-package-versions.

AWS CLI

Para listar as versões de um pacote

O exemplo list-package-versions a seguir retorna uma lista de versões de pacotes para um pacote chamado kind-of.

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

Saída:

{
    "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"
        }
    ]
}

Para obter mais informações, consulte Listar versões do pacote no Guia do usuário do AWS CodeArtifact.

  • Para ver detalhes da API, consulte ListPackageVersions na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar list-packages.

AWS CLI

Para listar pacotes em um repositório

O exemplo list-packages a seguir lista pacotes em um repositório chamado test-repo em um domínio chamado test-domain.

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

Saída:

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

Para obter mais informações, consulte Listar nomes de pacotes no Guia do usuário do AWS CodeArtifact.

  • Para ver detalhes da API, consulte ListPackages na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar list-repositories-in-domain.

AWS CLI

Para listar repositórios em um domínio

O exemplo list-repositories-in-domain a seguir retorna um resumo de todos os repositórios no domínio test-domain.

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

Saída:

{
    "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."
        }
    ]
}

Para obter mais informações, consulte Listar repositórios no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar list-repositories.

AWS CLI

Para listar repositórios

O exemplo list-repositories a seguir retorna um resumo de todos os repositórios no domínio de propriedade da conta da AWS que faz a chamada.

aws codeartifact list-repositories

Saída:

{
    "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."
        }
    ]
}

Para obter mais informações, consulte Listar repositórios no Guia do usuário do AWS CodeArtifact.

  • Para ver detalhes da API, consulte ListRepositories na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar login.

AWS CLI

Como configurar a autenticação no seu repositório com o comando de login

O exemplo login a seguir configura o gerenciador de pacotes npm com um repositório chamado test-repo em um domínio chamado test-domain.

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

Saída:

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

Para obter mais informações, consulte Introdução à AWS CLI no Guia do usuário do AWS CodeArtifact.

  • Para ver detalhes da API, consulte Login na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar put-domain-permissions-policy.

AWS CLI

Como anexar uma política de permissões a um domínio

O exemplo put-domain-permissions-policy a seguir anexa uma política de permissão definida no arquivo policy.json a um domínio chamado test-domain.

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

Saída:

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

Para obter mais informações, consulte Definir uma política de domínio no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar put-repository-permissions-policy.

AWS CLI

Como anexar uma política de permissões a um repositório

O exemplo put-repository-permissions-policy a seguir anexa uma política de permissão definida no arquivo policy.json a um repositório chamado test-repo.

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

Saída:

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

Para obter mais informações, consulte Definir uma política no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar update-package-versions-status.

AWS CLI

Para atualizar o status da versão do pacote

O exemplo update-package-versions-status a seguir atualiza o status da versão 4.0.0 do pacote test-package para Archived.

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

Saída:

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

Para obter mais informações, consulte Atualizar o status da versão do pacote no Guia do usuário do AWS CodeArtifact.

O código de exemplo a seguir mostra como usar update-repository.

AWS CLI

Para atualizar um repositório

O exemplo update-repository a seguir atualiza a descrição de um repositório chamado test-repo em um domínio chamado test-domain para “esta é uma descrição atualizada”.

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

Saída:

{
    "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": []
    }
}

Para obter mais informações, consulte Exibir ou modificar a configuração de um repositório no Guia do Usuário do AWS CodeArtifact.

  • Para ver detalhes da API, consulte UpdateRepository na Referência de comandos da AWS CLI.