

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# AWS Cloud Map espacios de nombres
<a name="working-with-namespaces"></a>

Un espacio de nombres es una entidad lógica AWS Cloud Map que se utiliza para agrupar los servicios de una aplicación con un nombre y un nivel de visibilidad comunes. Al crear un espacio de nombres, se especifica lo siguiente:
+ Un nombre que desee que utilice la aplicación para detectar instancias.
+ El método mediante el cual se AWS Cloud Map pueden descubrir las instancias de servicio en las que se registra. Puede decidir si sus recursos deben descubrirse públicamente a través de Internet, de forma privada en una nube privada virtual (VPC) específica o solo mediante llamadas a la API.

Los siguientes son conceptos generales sobre los espacios de nombres.
+ Los espacios de nombres son específicos del lugar en el Región de AWS que se crearon. Para usarlos AWS Cloud Map en varias regiones, tendrás que crear espacios de nombres en cada región.
+ Si crea un espacio de nombres para permitir, por ejemplo, la detección mediante consultas de DNS en una VPC, crea AWS Cloud Map automáticamente una zona alojada de Route 53 privada. Esta zona alojada se puede asociar a varias. VPCs Para obtener más información, consulte [Associate VPCWith HostedZone](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AssociateVPCWithHostedZone.html) in the *Amazon Route 53 API Reference*.

**Topics**
+ [Crear un espacio de AWS Cloud Map nombres para agrupar los servicios de aplicaciones](creating-namespaces.md)
+ [Listar espacios de AWS Cloud Map nombres](listing-namespaces.md)
+ [Eliminar un AWS Cloud Map espacio de nombres](deleting-namespaces.md)
+ [Espacios de AWS Cloud Map nombres compartidos](sharing-namespaces.md)

# Crear un espacio de AWS Cloud Map nombres para agrupar los servicios de aplicaciones
<a name="creating-namespaces"></a>

Puede crear un espacio de nombres para agrupar los servicios de su aplicación con un nombre descriptivo que permita descubrir los recursos de la aplicación mediante llamadas a la API o consultas de DNS.

## Opciones de descubrimiento de instancias
<a name="working-with-namespaces-instance-discovery"></a>

En la siguiente tabla, se resumen las diferentes opciones de detección de instancias AWS Cloud Map y el tipo de espacio de nombres correspondiente que puede crear, en función de los servicios y la configuración de la aplicación.


| Tipo de espacio de nombres | Método de descubrimiento de instancias | Funcionamiento | Información adicional | 
| --- | --- | --- | --- | 
| HTTP  | Llamadas a la API  | Los recursos de tu aplicación pueden descubrir otros recursos llamando únicamente a la DiscoverInstances API. |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/cloud-map/latest/dg/creating-namespaces.html)  | 
| DNS privado | Llamadas a la API y consultas de DNS en una VPC | Al crear un espacio de nombres DNS privado, AWS Cloud Map crea la correspondiente zona alojada privada de Amazon Route 53. Los recursos de su aplicación pueden descubrir otros recursos llamando a la `DiscoverInstances` API y consultando los servidores de nombres de la zona alojada privada de Route 53 que se crea automáticamente. AWS Cloud Map  La zona alojada creada por AWS Cloud Map tiene el mismo nombre que el espacio de nombres y contiene registros DNS con nombres en ese formato. *service-name* *namespace-name*.  El solucionador de Route 53 resuelve las consultas de DNS que se originan en la VPC utilizando los registros de la zona alojada privada. Si la zona alojada privada no incluye ningún registro que coincida con el nombre de dominio en una consulta de DNS, Route 53 responde a la consulta con `NXDOMAIN` (dominio no existente).   |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/cloud-map/latest/dg/creating-namespaces.html)  | 
| DNS público | Llamadas a la API y consultas públicas de DNS | Al crear un espacio de nombres DNS público, AWS Cloud Map crea la correspondiente zona alojada pública de Amazon Route 53. Los recursos de su aplicación pueden detectar otros recursos llamando a la `DiscoverInstances` API y consultando los servidores de nombres de la zona alojada pública de Route 53 que se crea automáticamente. AWS Cloud Map  La zona alojada pública tiene el mismo nombre que el espacio de nombres y contiene registros DNS con nombres en ese formato. *service-name* *namespace-name*.  En este caso, el nombre del espacio de nombres debe ser un nombre de dominio que hayas registrado.   |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/cloud-map/latest/dg/creating-namespaces.html)  | 

## Procedimiento
<a name="create-namespace-steps"></a>

Puedes seguir estos pasos para crear un espacio de nombres con AWS CLI Consola de administración de AWS, o el SDK para Python.

------
#### [ Consola de administración de AWS ]

1. Inicie sesión en Consola de administración de AWS y abra la AWS Cloud Map consola en. [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/)

1. Elija **Crear espacio de nombres**.

1. En el **campo Nombre del espacio** de nombres, introduce un nombre que se utilizará para detectar instancias.
**nota**  
Los espacios de nombres configurados para consultas de DNS públicas deben terminar en un dominio de nivel superior. Por ejemplo, `.com`.
Puede especificar un nombre de dominio internacionalizado (IDN) si convierte primero el nombre a Punycode. Para obtener información sobre convertidores online, busque en Internet “convertidor de punycode”.  
También puede convertir un nombre de dominio internacionalizado a Punycode al crear espacios de nombres mediante programación. Por ejemplo, si utiliza Java, puede convertir un valor Unicode a Punycode mediante el método `toASCII` de la biblioteca de IDN de java.net.

1. **(Opcional) En la **descripción del espacio de nombres**, introduzca la información sobre el espacio de nombres que estará visible en la página de espacios de nombres y en la sección Información del espacio de **nombres**.** Puede utilizar esta información para identificar fácilmente un espacio de nombres.

1. Para la **detección de instancias**, puedes elegir entre **llamadas a API, llamadas** **a API y consultas de DNS VPCs**, o **llamadas a API y consultas de DNS públicas** para crear un espacio de nombres HTTP, DNS privado o DNS público, respectivamente. Para obtener más información, consulte [Opciones de descubrimiento de instancias](#working-with-namespaces-instance-discovery).

   En función de lo que selecciones, sigue estos pasos.
   + Si eliges las **llamadas a la API y las consultas de DNS en VPCs**, para la **VPC**, elige una nube privada virtual (VPC) a la que quieras asociar el espacio de nombres.
   + Si eliges **llamadas a la API y consultas de DNS en VPCs** o **llamadas a la API y consultas de DNS públicas**, en el caso del **TTL**, especifica un valor numérico en segundos. El valor del tiempo de vida (TTL) determina durante cuánto tiempo los solucionadores de DNS almacenan en caché la información del registro DNS de inicio de autoridad (SOA) de la zona hospedada de Route 53 creada con su espacio de nombres. Para obtener más información sobre TTL, consulte [TTL (segundos)](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-values-shared.html#rrsets-values-common-ttl) en la Guía para *desarrolladores de Amazon Route 53*.

1. (Opcional) En **Etiquetas**, elija **Añadir etiquetas** y, a continuación, especifique una clave y un valor para etiquetar el espacio de nombres. Puede especificar una o varias etiquetas para agregarlas a su espacio de nombres de . Las etiquetas te permiten categorizar tus AWS recursos para que puedas administrarlos más fácilmente. Para obtener más información, consulte [Etiquetar sus recursos AWS Cloud Map](using-tags.md).

1. Elija **Crear espacio de nombres**. Puede ver el estado de la operación utilizando [ListOperations](https://docs.aws.amazon.com/cloud-map/latest/api/API_ListOperations.html). Para obtener más información, consulte [ListOperations](https://docs.aws.amazon.com/cloud-map/latest/api/API_ListOperations.html)la *referencia de la AWS Cloud Map API* 

------
#### [ AWS CLI ]
+ 

  Crea un espacio de nombres con el comando correspondiente al tipo de descubrimiento de instancias que prefieras (reemplaza *red* los valores por los tuyos).
  + Cree un espacio de nombres de HTTP usando `[create-http-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-http-namespace.html)`. Las instancias de servicio registradas con un espacio de nombres de HTTP pueden detectarse mediante una solicitud `DiscoverInstances` pero no con DNS.

    ```
    aws servicediscovery create-http-namespace --name name-of-namespace
    ```
  + Cree un espacio de nombre privado basado en DNS, que podrá verse solo dentro de una Amazon VPC especificada. Puede descubrir las instancias que se registraron con un espacio de nombres de DNS privado mediante una solicitud `DiscoverInstances` o mediante DNS.

    ```
    aws servicediscovery create-private-dns-namespace --name name-of-namespace --vpc vpc-xxxxxxxxx
    ```
  + Cree un espacio de nombres público basado en DNS que se pueda ver en Internet con `[create-public-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-public-dns-namespace.html)`. Puede descubrir las instancias que se registraron con un espacio de nombres DNS público mediante una solicitud `DiscoverInstances` o mediante DNS.

    ```
    aws servicediscovery create-public-dns-namespace --name name-of-namespace
    ```

------
#### [ AWS SDK for Python (Boto3) ]

1. Si aún no tiene `Boto3` instalado, puede encontrar las instrucciones de instalación, configuración y uso `Boto3` [aquí](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation).

1. Importe `Boto3` y use `servicediscovery` como su servicio.

   ```
   import boto3
   client = boto3.client('servicediscovery')
   ```

1. 

   Crea un espacio de nombres con el comando correspondiente al tipo de descubrimiento de instancias que prefieras (reemplaza *red* los valores por los tuyos):
   + Cree un espacio de nombres de HTTP usando `create_http_namespace()`. Las instancias de servicio registradas con un espacio de nombres de HTTP pueden detectarse usando `discover_instances()` pero no con DNS.

     ```
     response = client.create_http_namespace(
         Name='name-of-namespace',
     )
     # If you want to see the response
     print(response)
     ```
   + Cree un espacio de nombre privado basado en DNS, que podrá verse solo dentro de una Amazon VPC especificada. Puede descubrir las instancias que se registraron con un espacio de nombres DNS privado mediante una solicitud `discover_instances()` o mediante DNS.

     ```
     response = client.create_private_dns_namespace(
         Name='name-of-namespace',
         Vpc='vpc-1c56417b',
     )
     # If you want to see the response
     print(response)
     ```
   + Cree un espacio de nombres público basado en DNS que se pueda ver en Internet con `create_public_dns_namespace()`. Puede descubrir las instancias que se registraron con un espacio de nombres DNS público mediante una solicitud `discover_instances()` o mediante DNS.

     ```
     response = client.create_public_dns_namespace(
         Name='name-of-namespace',
     )
     # If you want to see the response
     print(response)
     ```
   + Salida de respuesta de ejemplo

     ```
     {
         'OperationId': 'gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd',
         'ResponseMetadata': {
             '...': '...',
         },
     }
     ```

------

## Siguientes pasos
<a name="create-namespace-next-steps"></a>

Tras crear un espacio de nombres, puede crear servicios en el espacio de nombres para agrupar los recursos de la aplicación que, de forma colectiva, sirvan para un propósito concreto en la aplicación. Un servicio actúa como plantilla para registrar los recursos de la aplicación como instancias. Para obtener más información sobre la creación AWS Cloud Map de servicios, consulte[Creación de un AWS Cloud Map servicio para un componente de la aplicación](creating-services.md).

# Listar espacios de AWS Cloud Map nombres
<a name="listing-namespaces"></a>

Tras crear los espacios de nombres, puedes ver una lista de los espacios de nombres que has creado siguiendo estos pasos.

------
#### [ Consola de administración de AWS ]

1. Inicia sesión en Consola de administración de AWS y abre la consola en. AWS Cloud Map [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/)

1. En el panel de navegación, selecciona **Espacios de nombres para ver una lista de los espacios** de nombres. Puede ordenar los espacios de nombres por nombre, descripción, modo de detección de instancias, propietario o ID del espacio de nombres. También puedes introducir el nombre o la ID de un espacio de nombres en el campo de búsqueda para localizar y ver un espacio de nombres específico.

------
#### [ AWS CLI ]
+ Enumere los espacios de nombres con el comando `[list-namespaces](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/list-namespaces.html)`.

  ```
  aws servicediscovery list-namespaces
  ```

------
#### [ AWS SDK for Python (Boto3) ]

1. Si aún no tiene `Boto3` instalado, puede encontrar las instrucciones de instalación, configuración y uso `Boto3` [aquí](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation).

1. Importe `Boto3` y use `servicediscovery` como su servicio.

   ```
   import boto3
   client = boto3.client('servicediscovery')
   ```

1. Enumere los espacios de nombres con `list_namespaces()`.

   ```
   response = client.list_namespaces()
   # If you want to see the response
   print(response)
   ```

   Salida de respuesta de ejemplo

   ```
   {
       'Namespaces': [
           {
               'Arn': 'arn:aws::servicediscovery:us-west-2:123456789012:namespace/ns-xxxxxxxxxxxxxxx',
               'CreateDate': 1585354387.357,
               'Id': 'ns-xxxxxxxxxxxxxxx',
               'Name': 'myFirstNamespace',
               'Properties': {
                   'DnsProperties': {
                       'HostedZoneId': 'Z06752353VBUDTC32S84S',
                   },
                   'HttpProperties': {
                       'HttpName': 'myFirstNamespace',
                   },
               },
               'Type': 'DNS_PRIVATE',
           },
           {
               'Arn': 'arn:aws::servicediscovery:us-west-2:123456789012:namespace/ns-xxxxxxxxxxxxxxx',
               'CreateDate': 1586468974.698,
               'Description': 'My second namespace',
               'Id': 'ns-xxxxxxxxxxxxxxx',
               'Name': 'mySecondNamespace.com',
               'Properties': {
                   'DnsProperties': {
                   },
                   'HttpProperties': {
                       'HttpName': 'mySecondNamespace.com',
                   },
               },
               'Type': 'HTTP',
           },
           {
               'Arn': 'arn:aws::servicediscovery:us-west-2:123456789012:namespace/ns-xxxxxxxxxxxxxxx',
               'CreateDate': 1587055896.798,
               'Id': 'ns-xxxxxxxxxxxxxxx',
               'Name': 'myThirdNamespace.com',
               'Properties': {
                   'DnsProperties': {
                       'HostedZoneId': 'Z09983722P0QME1B3KC8I',
                   },
                   'HttpProperties': {
                       'HttpName': 'myThirdNamespace.com',
                   },
               },
               'Type': 'DNS_PRIVATE',
           },
       ],
       'ResponseMetadata': {
           '...': '...',
       },
   }
   ```

------

# Eliminar un AWS Cloud Map espacio de nombres
<a name="deleting-namespaces"></a>

Cuando termines de usar un espacio de nombres, puedes eliminarlo. Al eliminar un espacio de nombres, ya no podrá utilizarlo para registrar o detectar instancias de servicio.

**nota**  
 Al eliminar un espacio de nombres DNS, AWS Cloud Map elimina la zona hospedada de Amazon Route 53 correspondiente que se creó durante la creación del espacio de nombres.

Antes de eliminar un espacio de nombres, debe anular el registro de todas las instancias de servicio y, a continuación, eliminar todos los servicios que se crearon en el espacio de nombres. Para obtener más información, consulte [Anular el registro de una instancia de servicio AWS Cloud Map](deregistering-instances.md) y [Eliminar un AWS Cloud Map servicio](deleting-services.md).

Después de anular el registro de las instancias y eliminar los servicios que se crearon en un espacio de nombres, sigue estos pasos para eliminar el espacio de nombres.

------
#### [ Consola de administración de AWS ]

1. Inicia sesión en y abre la consola en. Consola de administración de AWS AWS Cloud Map [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/)

1. En el panel de navegación, seleccione **Namespaces (Espacios de nombres)**.

1. **Seleccione el espacio de nombres que desee eliminar y, a continuación, elija Eliminar.**

1. Confirma que deseas eliminar el servicio; para ello, vuelve a seleccionar **Eliminar**.

------
#### [ AWS CLI ]
+ Elimine un espacio de nombres con el `[delete-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/delete-namespace.html)` comando (sustituya el *red* valor por el suyo propio). Si el espacio de nombres aún contiene uno o más servicios, se producirá un error en la solicitud.

  ```
  aws servicediscovery delete-namespace --id ns-xxxxxxxxxxx
  ```

------
#### [ AWS SDK for Python (Boto3) ]

1. Si aún no tiene `Boto3` instalado, puede encontrar las instrucciones de instalación, configuración y uso `Boto3` [aquí](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation).

1. Importe `Boto3` y use `servicediscovery` como su servicio.

   ```
   import boto3
   client = boto3.client('servicediscovery')
   ```

1. Elimine un espacio de nombres por `delete_namespace()` (sustituya el *red* valor por el suyo propio). Si el espacio de nombres aún contiene uno o más servicios, se producirá un error en la solicitud.

   ```
   response = client.delete_namespace(
       Id='ns-xxxxxxxxxxx',
   )
   # If you want to see the response
   print(response)
   ```

   Salida de respuesta de ejemplo

   ```
   {
       'OperationId': 'gv4g5meo7ndmeh4fqskygvk23d2fijwa-k98y6drk',
       'ResponseMetadata': {
           '...': '...',
       },
   }
   ```

------

# Espacios de AWS Cloud Map nombres compartidos
<a name="sharing-namespaces"></a>

AWS Cloud Map permite a los propietarios de los espacios de nombres compartir sus espacios de nombres con otras personas Cuentas de AWS o dentro de una organización AWS Organizations para simplificar la detección y el registro de servicios entre cuentas. Esto facilita el uso de los espacios de nombres gestionados por otras personas o por equipos de una organización. Cuentas de AWS AWS 

AWS Cloud Map se integra con AWS Resource Access Manager (AWS RAM) para permitir el intercambio de recursos. AWS RAM es un servicio que le permite compartir algunos AWS Cloud Map recursos con otros Cuentas de AWS o a través de ellos AWS Organizations. Con AWS RAM, puede compartir los recursos de su propiedad mediante la creación de un *recurso compartido*. Un uso compartido de recursos especifica los recursos que compartir y los consumidores con quienes compartirlos. Los consumidores pueden incluir lo siguiente:
+ Específico Cuentas de AWS dentro de su organización en AWS Organizations
+ Una unidad organizativa dentro de su organización en AWS Organizations
+ Toda su organización en AWS Organizations

Para obtener más información al respecto AWS RAM, consulte la *[Guía AWS RAM del usuario](https://docs.aws.amazon.com/ram/latest/userguide/)*.

En este tema se explica cómo compartir los recursos que le pertenecen y cómo utilizar los recursos que se comparten con usted.

**Topics**
+ [Consideraciones sobre el uso compartido de espacios de nombres](#sharing-considerations)
+ [Compartir un espacio de nombres AWS Cloud Map](sharing-share.md)
+ [Dejar de compartir un espacio de nombres AWS Cloud Map](sharing-unshare.md)
+ [Identificar un espacio de nombres compartido AWS Cloud Map](sharing-identify.md)
+ [Otorgar permisos para compartir un espacio de nombres](#granting-perms-to-share)
+ [Responsabilidades y permisos de los espacios de nombres compartidos](#sharing-perms)
+ [Facturación y medición](#sharing-billing)
+ [Cuotas](#sharing-quotas)

## Consideraciones sobre el uso compartido de espacios de nombres
<a name="sharing-considerations"></a>
+ Para compartir un espacio de nombres, debes tenerlo en tu. Cuenta de AWS Esto significa que el recurso debe asignarse o suministrarse en su cuenta. No puedes compartir un espacio de nombres que se haya compartido contigo.
+ Para compartir un espacio de nombres con tu organización o unidad organizativa AWS Organizations, debes habilitar el uso compartido con. AWS Organizations Para obtener más información, consulte [Habilitar el uso compartido con AWS Organizations](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-orgs) en la *Guía del usuario de AWS RAM *.
+ Para la detección de servicios mediante consultas de DNS en un espacio de nombres DNS privado compartido, el propietario del espacio de nombres tendrá que llamar `create-vpc-association-authorization` con el ID de la zona alojada privada asociada al espacio de nombres y a la VPC del consumidor.

  ```
  aws route53 create-vpc-association-authorization --hosted-zone-id Z1234567890ABC --vpc VPCRegion=us-east-1,VPCId=vpc-12345678
  ```

  El consumidor del espacio de nombres tendrá que llamar a `associate-vpc-with-hosted-zone` con el ID de la zona alojada privada.

  ```
  aws route53 associate-vpc-with-hosted-zone --hosted-zone-id Z1234567890ABC --vpc VPCRegion=us-east-1,VPCId=vpc-12345678
  ```

  Para obtener más información, consulte [Asociar una VPC de Amazon y una zona alojada privada con la que haya creado Cuentas de AWS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zone-private-associate-vpcs-different-accounts.html) diferentes en la Guía para desarrolladores de *Amazon Route 53*.
+ Tras descubrir las ubicaciones de up-to-date red de los servicios asociados a un espacio de nombres DNS compartido, puede que sea necesario configurar la conectividad entre VPC para comunicarse con los servicios si están en lugares diferentes. VPCs Esto se puede lograr mediante una conexión de emparejamiento de VPC. Para obtener más información, consulte [Creación o eliminación de una interconexión de VPC](https://docs.aws.amazon.com/vpc/latest/peering/create-vpc-peering-connection.html) en la *Guía de emparejamiento de VPC de Amazon Virtual Private Cloud*.
+ No se puede utilizar `ListOperations` para enumerar las operaciones en los espacios de nombres compartidos que realizan otras cuentas.
+ No se admite el etiquetado en los espacios de nombres compartidos.

# Compartir un espacio de nombres AWS Cloud Map
<a name="sharing-share"></a>

 Cuando compartes un espacio de AWS Cloud Map nombres que te pertenece con otros Cuentas de AWS (consumidores), permites que estas cuentas descubran las ubicaciones de up-to-date red de los servicios del espacio de nombres sin necesidad de credenciales temporales.

Para compartir un espacio de nombres, debe agregarlo a un recurso compartido. Un recurso compartido es un recurso de AWS RAM que le permite compartir los recursos a través de Cuentas de AWS. Un recurso compartido especifica los recursos que compartir y los consumidores con quienes se comparten. [Para añadir el espacio de nombres a un nuevo recurso compartido, primero debe crear el recurso compartido mediante la consola.AWS RAM](https://console.aws.amazon.com/ram)

Si forma parte de una organización AWS Organizations y está habilitado el uso compartido dentro de su organización, los consumidores de su organización tienen acceso automático al espacio de nombres compartido. De lo contrario, los consumidores reciben una invitación para unirse al recurso compartido y se les concede acceso al espacio de nombres compartido tras aceptar la invitación.

Puedes compartir un espacio de nombres de tu propiedad mediante la consola o el AWS RAM . AWS CLI

------
#### [ AWS RAM console ]

**Para compartir un espacio de nombres de tu propiedad mediante la consola AWS RAM**  
Consulte [Creating a resource share in AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing-create.html) en la *Guía del usuario de AWS RAM *.

------
#### [ AWS CLI ]

**Para compartir un espacio de nombres de tu propiedad mediante el AWS CLI**  
Utilice el comando AWS RAM [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html).

------

# Dejar de compartir un espacio de nombres AWS Cloud Map
<a name="sharing-unshare"></a>

Cuando un espacio de nombres ya no se comparte, el consumidor ya no puede acceder al espacio de nombres ni a los servicios e instancias asociados a él. Cuentas de AWS Esto incluye los recursos creados en el espacio de nombres por los consumidores cuando tenían acceso al espacio de nombres.

Para dejar de compartir un espacio de nombres de su propiedad, debe eliminarlo del recurso compartido. Puede hacerlo mediante la AWS RAM consola o el. AWS CLI

------
#### [ AWS RAM console ]

**Para dejar de compartir un espacio de nombres de tu propiedad mediante la consola AWS RAM**  
Consulte [Actualización de un recurso compartido](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing-update.html) en la *Guía del usuario de AWS RAM *.

------
#### [ AWS CLI ]

**Para dejar de compartir un espacio de nombres de su propiedad mediante el AWS CLI**  
Utilice el comando [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html).

------

# Identificar un espacio de nombres compartido AWS Cloud Map
<a name="sharing-identify"></a>

Los propietarios y los consumidores pueden identificar los espacios de nombres compartidos mediante la consola y. AWS Cloud Map AWS CLI El propietario del espacio de nombres se puede identificar mediante la propiedad. `ResourceOwner` El Cuenta de AWS que crea un servicio o registra una instancia en el espacio de nombres compartido se puede identificar mediante la propiedad. `CreatedByAccount`

------
#### [ AWS Cloud Map console ]

**Para identificar un espacio de nombres compartido mediante la consola AWS Cloud Map**

1. Inicie sesión en Consola de administración de AWS y abra la AWS Cloud Map consola en. [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/)

1. En la página de **espacios de nombres**, en **Propietario del recurso**, encontrarás el ID del propietario del Cuenta de AWS espacio de nombres.

1. Elige el **nombre de dominio del** espacio de nombres que quieres identificar.

1. En la *namespace-name* página Espacio de **nombres**, en la sección de **información del espacio de nombres**, en **Propietario del recurso, encontrarás el ID del propietario** del espacio de nombres. Cuenta de AWS 

------
#### [ AWS CLI ]

[Para identificar un espacio de nombres compartido mediante el comando list-namespaces. AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/list-namespaces.html) El comando devuelve los espacios de nombres de su propiedad y los espacios de nombres que comparte con usted. El `ResourceOwner` campo muestra el ID de AWS cuenta del propietario del espacio de nombres.

La siguiente `list-namespaces` llamada se realiza por cuenta. `111122223333`

```
aws servicediscovery list-namespaces
```

Salida:

```
{
    "Namespaces": [
        {
            "Arn": "arn:aws:servicediscovery:us-west-2:111122223333:namespace/ns-abcdef01234567890",
            "CreateDate": 1585354387.357,
            "Id": "ns-abcdef01234567890",
            "Name": "local",
            "Properties": {
                "DnsProperties": {
                    "HostedZoneId": "Z06752353VBUDTC32S84S"
                },
                "HttpProperties": {
                    "HttpName": "local"
                 }
            },
            "Type": "DNS_PRIVATE",
            "ServiceCount": 2,
           "ResourceOwner": "111122223333"
        },
        {
            "Arn": "arn:aws:servicediscovery:us-west-2:444455556666:namespace/ns-021345abcdef6789",
            "CreateDate": 1586468974.698,
            "Description": "Shared second namespace",
            "Id": "ns-021345abcdef6789",
            "Name": "My-second-namespace",
            "Properties": {
                "DnsProperties": {},
                "HttpProperties": {
                    "HttpName": "Shared-second-namespace"
                }
            },
            "Type": "HTTP",
            "ServiceCount": 0,
            "ResourceOwner": "444455556666"
        }
    ]
}
```

En este escenario, el espacio de nombres `ns-abcdef01234567890` se crea y es propiedad de, y el espacio de nombres `ns-021345abcdef6789` es creado `111122223333` y es propiedad de. `444455556666` El espacio de nombres se comparte cuenta por `ns-021345abcdef6789` cuenta. `111122223333` `444455556666`

------

## Otorgar permisos para compartir un espacio de nombres
<a name="granting-perms-to-share"></a>

Se requiere un conjunto mínimo de permisos para que un director de IAM comparta un espacio de nombres. Recomendamos utilizar las políticas `AWSResourceAccessManagerFullAccess` administradas `AWSCloudMapFullAccess` y las políticas administradas para garantizar que los directores de IAM tengan los permisos necesarios para compartir y usar los espacios de nombres compartidos.

Si utilizas una política de IAM personalizada, las `servicediscovery:DeleteResourcePolicy` acciones y las `servicediscovery:PutResourcePolicy` acciones son necesarias para `servicediscovery:GetResourcePolicy` compartir los espacios de nombres. Estas son acciones de IAM solo de permiso. Si a un director de IAM no se le conceden estos permisos, se producirá un error al intentar compartir el espacio de nombres utilizando. AWS RAM

*Para obtener más información sobre cómo se AWS RAM usa IAM, consulte [Cómo se AWS RAM usa IAM](https://docs.aws.amazon.com/ram/latest/userguide/security-iam-policies.html) en la Guía del usuario.AWS RAM *

## Responsabilidades y permisos de los espacios de nombres compartidos
<a name="sharing-perms"></a>

El propietario y el consumidor del espacio de nombres pueden realizar diferentes acciones en un espacio de nombres compartido.

### Permisos de los propietarios
<a name="perms-owner"></a>

El propietario de un espacio de nombres puede realizar las siguientes acciones en un espacio de nombres compartido:
+ Acceda a los servicios asociados al espacio de nombres, incluidos los servicios creados por las cuentas de los consumidores y las instancias registradas en estos servicios.
+ Revoca el acceso al espacio de nombres, incluido el acceso a los servicios creados por las cuentas de los consumidores y las instancias registradas en estos servicios.
+ Configure los permisos para que otras cuentas registren y cancelen el registro las instancias de los servicios creados en el espacio de nombres compartido por los consumidores o el propietario del espacio de nombres.
+ Elimine los servicios y anule el registro de las instancias, incluidos los servicios creados y las instancias registradas por las cuentas de los consumidores.
+ Actualiza o elimina un espacio de nombres compartido.

### Permisos de los consumidores
<a name="perms-consumer"></a>

Un consumidor de un espacio de nombres puede realizar las siguientes acciones en un espacio de nombres compartido:
+ Cree y elimine servicios en el espacio de nombres.
+ Registra y anula el registro de instancias en los servicios creados en el espacio de nombres.
+ Descubra las instancias que están registradas en los servicios creados en el espacio de nombres.

Un consumidor no puede actualizar ni eliminar un espacio de nombres compartido. Tras perder el acceso al espacio de nombres compartido, las cuentas de los consumidores también perderán el acceso a los servicios que hayan creado en el espacio de nombres.

## Facturación y medición
<a name="sharing-billing"></a>

A los propietarios se les facturan las instancias que registren en el espacio de nombres compartido y las comprobaciones de estado de Route 53 que se creen al registrar estas instancias. A los consumidores se les facturan las instancias que registren en el espacio de nombres y las comprobaciones de estado de Route 53 que se creen al registrar estas instancias. Si el espacio de nombres compartido es un espacio de nombres DNS, se facturan al propietario del espacio de nombres los registros DNS de Route 53 que se crean cuando se crean los servicios en el espacio de nombres. A los propietarios se les facturan todas las llamadas que realicen. `DiscoverInstances` `DiscoverInstancesRevision` A los consumidores se les facturan todas `DiscoverInstances` las `DiscoverInstancesRevision` llamadas que realicen.

## Cuotas
<a name="sharing-quotas"></a>

Los espacios de nombres compartidos solo se incluyen en la cuota de espacios de nombres del propietario del espacio de nombres por región. Las instancias registradas por un consumidor en el espacio de nombres compartido se incluyen en la cuota de instancias por espacio de nombres del propietario. Si un consumidor crea un servicio en un espacio de nombres compartido, todas las instancias registradas en el servicio se tienen en cuenta para la cuota de instancias por servicio del consumidor. Si un propietario crea un servicio en un espacio de nombres compartido, todas las instancias registradas en el servicio se tienen en cuenta para la cuota de instancias por servicio del propietario.