---
title: Rancher Find Container
slug: homologacao-atmosphere/rancher-find-container
description: Learn how to find a container in Rancher using the API with this comprehensive document. Discover the necessary parameters, such as the URL, access key, and secret key, along with optional filters for a more refined search. Get started with an example YAM
docTags: 
createdAt: 2021-03-25T19:32:37.000Z
---

## Resumo

- Procure uma referência de contêiner no Rancher

## Parâmetros

| **Parâmetro**                   | **Tipo**   | **Escolhas \| Valor Padrão** | **Comentários**                         |
| ------------------------------- | ---------- | ---------------------------- | --------------------------------------- |
| url - *required*                | string     |                              | Url da API Rancher.                     |
| access\_key - *required  * | string     |                              | Chave de acesso da API Rancher.         |
| secret\_key - *required*        | string     |                              | Rancher Secret.                         |
| filters                         | dictionary | - \{}<br />(default)         | Uma lista de filtros a serem aplicados. |



## Exemplos

```yaml
# Exemplo: Buscar contêiner Rancher
- rancher_find_container:
    url: http://url/api-version
    access_key: ACCESS_KEY
    secret_key: SECRET_KEY
    docker_inspect: DOCKER_NAME
    filters: 
        name: CONTAINER_NAME
  register: result
```