As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Listar nomes de pacotes
<a name="list-packages"></a>

Use o `list-packages` comando in CodeArtifact para obter uma lista de todos os nomes de pacotes em um repositório. Esse comando retorna apenas os nomes dos pacotes, não as versões.

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo
```

Exemplo de saída:

```
{
    "nextToken": "eyJidWNrZXRJZCI6I...",
    "packages": [
        {
            "package": "acorn",
            "format": "npm",
            "originConfiguration": {
                "restrictions": {
                    "publish": "BLOCK",
                    "upstream": "ALLOW"
            }
        },
        {
            "package": "acorn-dynamic-import",
            "format": "npm",
            "originConfiguration": {
                "restrictions": {
                    "publish": "BLOCK",
                    "upstream": "ALLOW"
            }
        },
        {
            "package": "ajv",
            "format": "npm",
            "originConfiguration": {
                "restrictions": {
                    "publish": "BLOCK",
                    "upstream": "ALLOW"
            }
        },
        {
            "package": "ajv-keywords",
            "format": "npm",
            "originConfiguration": {
                "restrictions": {
                    "publish": "BLOCK",
                    "upstream": "ALLOW"
            }
        },
        {
            "package": "anymatch",
            "format": "npm",
            "originConfiguration": {
                "restrictions": {
                    "publish": "BLOCK",
                    "upstream": "ALLOW"
            }
        },
        {
            "package": "ast",
            "namespace": "webassemblyjs",
            "format": "npm",
            "originConfiguration": {
                "restrictions": {
                    "publish": "BLOCK",
                    "upstream": "ALLOW"
            }
        }
    ]
}
```

## Listar nomes de pacotes npm
<a name="list-packages-npm"></a>

Para listar apenas os nomes dos pacotes npm, defina o valor da opção `--format` como `npm`.

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo  \
    --format npm
```

Para listar pacotes npm em um namespace (*escopo* npm), use as opções `--namespace` e `--format`.

**Importante**  
O valor da opção `--namespace` não deve incluir o `@` inicial. Para pesquisar o namespace`@types`, defina o valor como. *types*

**nota**  
A opção `--namespace` filtra por prefixo de namespace. Qualquer pacote npm com um escopo que comece com o valor passado para a opção `--namespace` será retornado na resposta `list-packages`.

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo  \
    --format npm --namespace types
```

Exemplo de saída:

```
{
    "nextToken": "eyJidWNrZXRJZ...",
    "packages": [
        {
            "package": "3d-bin-packing",
            "namespace": "types",
            "format": "npm"

        },
        {
            "package": "a-big-triangle",
            "namespace": "types",
            "format": "npm"

        },
        {
            "package": "a11y-dialog",
            "namespace": "types",
            "format": "npm"

        }
    ]
}
```

## Listar nomes de pacotes Maven
<a name="list-packages-maven"></a>

Para listar apenas os nomes dos pacotes Maven, defina o valor da opção `--format` como `maven`. Você também deve especificar o ID do grupo Maven na opção `--namespace`.

**nota**  
A opção `--namespace` filtra por prefixo de namespace. Qualquer pacote npm com um escopo que comece com o valor passado para a opção `--namespace` será retornado na resposta `list-packages`.

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo  \
    --format maven --namespace org.apache.commons
```

Exemplo de saída:

```
{
    "nextToken": "eyJidWNrZXRJZ...",
    "packages": [
        {
            "package": "commons-lang3",
            "namespace": "org.apache.commons",
            "format": "maven"

        },
        {
            "package": "commons-collections4",
            "namespace": "org.apache.commons",
            "format": "maven"

        },
        {
            "package": "commons-compress",
            "namespace": "org.apache.commons",
            "format": "maven"

        }
    ]
}
```

## Listar nomes de pacotes Python
<a name="list-packages-python"></a>

Para listar apenas os nomes dos pacotes Python, defina o valor da opção `--format` como `pypi`.

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo  \
    --format pypi
```

## Filtrar por prefixo do nome do pacote
<a name="list-packages-package-prefix"></a>

 Para retornar pacotes que começam com uma string especificada, você pode usar a opção `--package-prefix`. 

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo  \
    --format npm --package-prefix pat
```

Exemplo de saída:

```
{
    "nextToken": "eyJidWNrZXRJZ...",
    "packages": [
        {
            "package": "path",
            "format": "npm"

        },
        {
            "package": "pat-test",
            "format": "npm"

        },
        {
            "package": "patch-math3",
            "format": "npm"

        }
    ]
}
```

## Combinações de opções de pesquisa compatíveis
<a name="list-packages-option-combinations"></a>

Você pode usar as opções `--format`, `--namespace` e `--package-prefix` em qualquer combinação, exceto que `--namespace` não pode ser usada sozinha. Pesquisar todos os pacotes npm com um escopo que começa com `@types` exige que a opção `--format` seja especificada. Usar `--namespace` por si só resulta em um erro. 

 Não usar nenhuma das três opções também é compatível com `list-packages` e retornará todos os pacotes de todos os formatos presentes no repositório. 

## Formatar resultado
<a name="list-packages-format-output"></a>

 Você pode usar parâmetros que estão disponíveis para todos os AWS CLI comandos para tornar a `list-packages` resposta compacta e mais legível. Use o parâmetro `--query` para especificar o formato de cada versão de pacote retornada. Use o parâmetro `--output` para formatar a resposta como texto sem formatação. 

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo \
  --output text --query 'packages[*].[package]'
```

Exemplo de saída:

```
accepts
array-flatten
body-parser
bytes
content-disposition
content-type
cookie
cookie-signature
```

 Para obter mais informações, consulte [Controlar a saída do comando de AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html) no *Guia do usuário do AWS Command Line Interface *. 

## Padrões e outras opções
<a name="list-packages-defaults-options"></a>

 Por padrão, o número máximo de resultados retornados por `list-packages` é 100. Você pode alterar esse limite de resultados usando a opção `--max-results`.

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo --max-results 20
```

O valor máximo permitido de `--max-results` é 1.000. Para permitir a listagem de pacotes em repositórios com mais de 1.000 pacotes, `list-packages` é compatível com a paginação usando o campo `nextToken` na resposta. Se o número de pacotes no repositório for maior que o valor de `--max-results`, você poderá passar o valor de `nextToken` para outra invocação de `list-packages` para obter a próxima página de resultados.

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo \
  --next-token rO0ABXNyAEdjb...
```