

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.

# Obtenga un valor de atributo AWS CloudHSM clave mediante CMU
<a name="cloudhsm_mgmt_util-getAttribute"></a>

Usa el **getAttribute** comando AWS CloudHSM cloudhsm\_mgmt\_util (CMU) para obtener un valor de atributo para una clave de todos los módulos de seguridad de hardware (HSM) del AWS CloudHSM clúster y escribirlo en stdout (salida estándar) o en un archivo. Solo CUs los usuarios de criptomonedas () pueden ejecutar este comando. 

Los *atributos de la clave* son las propiedades de una clave. Contienen características, como el tipo de clave, clase, etiqueta e ID y los valores que representan las acciones que puede desempeñar en la clave, como cifrar, descifrar, encapsular, firmar y verificar. 

Solamente puede utilizar **getAttribute** en claves que sean de su propiedad y que hayan compartido con usted. Puede ejecutar este comando o el comando [getAttribute](#cloudhsm_mgmt_util-getAttribute) en key\_mgmt\_util, que escribe uno o todos los valores de atributo de una clave en un archivo. 

Para obtener una lista de los atributos y las constantes que los representan, ejecute el comando [listAttributes](key_mgmt_util-listAttributes.md). Para cambiar los valores de los atributos de las claves existentes, utilice [setAttribute](key_mgmt_util-setAttribute.md) en key\_mgmt\_util y [setAttribute](cloudhsm_mgmt_util-setAttribute.md) en cloudhsm\_mgmt\_util. Para obtener ayuda para interpretar los atributos de clave, consulte la [AWS CloudHSM referencia de atributo clave para KMU](key-attribute-table.md).

Para poder ejecutar cualquier comando de CMU, debe iniciar la CMU e iniciar sesión en el HSM. Asegúrese de que inicia sesión con un tipo de usuario que pueda ejecutar los comandos que planea utilizar.

Si añade o elimina HSMs, actualice los archivos de configuración de la CMU. De lo contrario, es posible que los cambios que realice no sean efectivos para todos HSMs los miembros del clúster.

## Tipo de usuario
<a name="chmu-getAttribute-userType"></a>

Los usuarios siguientes pueden ejecutar este comando.
+ Usuarios de criptografía (CU)

## Sintaxis
<a name="chmu-getAttribute-syntax"></a>

Dado que estos comandos no tienen parámetros designados, debe introducir los argumentos en el orden especificado en los diagramas de sintaxis.

```
getAttribute {{<key handle>}} {{<attribute id>}} [{{<filename>}}]
```

## Ejemplo
<a name="chmu-getAttribute-examples"></a>

En este ejemplo se obtiene el valor del atributo extraíble de una clave del HSMs. Puede usar un comando como este para determinar si puede exportar una clave desde. HSMs 

El primer comando utiliza [listAttributes](cloudhsm_mgmt_util-listAttributes.md) para encontrar la constante que representa el atributo extraíble. La salida muestra que la constante de `OBJ_ATTR_EXTRACTABLE` es `354`. Encontrará también esta información con las descripciones de los atributos y sus valores, en la [AWS CloudHSM referencia de atributo clave para KMU](key-attribute-table.md).

```
aws-cloudhsm> listAttributes

Following are the possible attribute values for getAttribute:

      OBJ_ATTR_CLASS                  = 0
      OBJ_ATTR_TOKEN                  = 1
      OBJ_ATTR_PRIVATE                = 2
      OBJ_ATTR_LABEL                  = 3
      OBJ_ATTR_TRUSTED                = 134
      OBJ_ATTR_KEY_TYPE               = 256
      OBJ_ATTR_ID                     = 258
      OBJ_ATTR_SENSITIVE              = 259
      OBJ_ATTR_ENCRYPT                = 260
      OBJ_ATTR_DECRYPT                = 261
      OBJ_ATTR_WRAP                   = 262
      OBJ_ATTR_UNWRAP                 = 263
      OBJ_ATTR_SIGN                   = 264
      OBJ_ATTR_VERIFY                 = 266
      OBJ_ATTR_DERIVE                 = 268
      OBJ_ATTR_LOCAL                  = 355
      OBJ_ATTR_MODULUS                = 288
      OBJ_ATTR_MODULUS_BITS           = 289
      OBJ_ATTR_PUBLIC_EXPONENT        = 290
      OBJ_ATTR_VALUE_LEN              = 353
      OBJ_ATTR_EXTRACTABLE            = 354
      OBJ_ATTR_NEVER_EXTRACTABLE      = 356
      OBJ_ATTR_ALWAYS_SENSITIVE       = 357
      OBJ_ATTR_DESTROYABLE            = 370
      OBJ_ATTR_KCV                    = 371
      OBJ_ATTR_WRAP_WITH_TRUSTED      = 528      
      OBJ_ATTR_WRAP_TEMPLATE          = 1073742353
      OBJ_ATTR_UNWRAP_TEMPLATE        = 1073742354
      OBJ_ATTR_ALL                    = 512
```

El segundo comando se utiliza **getAttribute** para obtener el valor del atributo extraíble de la clave con el identificador de tecla `262170` en. HSMs Para especificar el atributo extraíble, el comando utiliza `354`, la constante que representa el atributo. Como el comando no especifica el nombre de archivo, **getAttribute** escribe la salida en stdout.

La salida muestra que el valor del atributo extraíble es 1 en todos los HSM. Este valor indica que el propietario de la clave puede exportarla. Cuando el valor es 0 (0x0), no se puede exportar desde. HSMs El valor del atributo extraíble se establece al crear la clave, pero no se puede cambiar.

```
aws-cloudhsm> getAttribute 262170 354

Attribute Value on server 0(10.0.1.10):
OBJ_ATTR_EXTRACTABLE
0x00000001

Attribute Value on server 1(10.0.1.12):
OBJ_ATTR_EXTRACTABLE
0x00000001

Attribute Value on server 2(10.0.1.7):
OBJ_ATTR_EXTRACTABLE
0x00000001
```

## Argumentos
<a name="chmu-getAttribute-params"></a>

Dado que estos comandos no tienen parámetros designados, debe introducir los argumentos en el orden especificado en los diagramas de sintaxis.

```
getAttribute {{<key handle>}} {{<attribute id>}} [{{<filename>}}]
```

**<key-handle>**  
Especifica el identificador de la clave de destino. Puede especificar una única clave en cada comando. Para obtener el identificador de una clave, use [findKey](key_mgmt_util-findKey.md) en key\_mgmt\_util.   
Debe ser propietario de la clave especificada o esta debe compartirse con usted. Para buscar los usuarios de una clave, utilice [getKeyInfo](key_mgmt_util-getKeyInfo.md)key\_mgmt\_util.   
Obligatorio: sí

**<attribute id>**  
Identifica el atributo. Escriba una constante que represente un atributo o `512`, que representa todos los atributos. Por ejemplo, para obtener el tipo de clave, especifique `256`, que es la constante del atributo `OBJ_ATTR_KEY_TYPE`.  
Para generar una lista de los atributos y sus constantes, utilice [listAttributes](key_mgmt_util-listAttributes.md). Para obtener ayuda para interpretar los atributos de clave, consulte la [AWS CloudHSM referencia de atributo clave para KMU](key-attribute-table.md).  
Obligatorio: sí

**<filename>**  
Escribe la salida en el archivo especificado. Escriba una ruta de archivo.  
Si el archivo especificado existe, **getAttribute** sobrescribe el archivo sin ningún tipo de advertencia.  
Obligatorio: no  
Valor predeterminado: stdout

## Temas relacionados
<a name="chmu-getAttribute-seealso"></a>
+ [getAttribute](key_mgmt_util-getAttribute.md) en key\_mgmt\_util
+ [listAttributes](cloudhsm_mgmt_util-listAttributes.md)
+ [setAttribute](cloudhsm_mgmt_util-setAttribute.md) en cloudhsm\_mgmt\_util
+ [setAttribute](key_mgmt_util-setAttribute.md) en key\_mgmt\_util
+ [Referencia de los atributos de claves](key-attribute-table.md)