Claves de condiciones, recursos y acciones para AWS DeepComposer

AWS DeepComposer (prefijo de servicio:deepcomposer) proporciona los siguientes recursos, acciones y claves de contexto de condiciones específicos del servicio para su uso en las políticas de permisos de IAM.

Referencias:

• Obtenga información para configurar este servicio.

• Vea una lista de las operaciones de API disponibles para este servicio.

• Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos de IAM.

Acciones definidas por AWS DeepComposer

Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.

La columna Tipos de recurso de la tabla de Acción indica si cada acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") a los que aplica la política en el elemento Resource de la instrucción de su política. Si la columna incluye un tipo de recurso, puede especificar un ARN de ese tipo en una instrucción con dicha acción. Si la acción tiene uno o más recursos necesarios, la persona que llama debe tener permiso para usar la acción con esos recursos. Los recursos necesarios se indican en la tabla con un asterisco (*). Si limita el acceso a los recursos con el elemento Resource de una política de IAM, debe incluir un ARN o patrón para cada tipo de recurso requerido. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno de los tipos de recursos opcionales.

La columna Claves de condición de la tabla Acciones incluye claves que puede especificar en el elemento Condition de la instrucción de una política. Para obtener más información sobre las claves de condición asociadas a los recursos del servicio, consulte la columna Claves de condición de la tabla Tipos de recursos.

nota

Las claves de condición de recursos se enumeran en la tabla Tipos de recursos. Encontrará un enlace al tipo de recurso que se aplica a una acción en la columna Tipos de recursos (*obligatorio) de la tabla Acciones. El tipo de recurso de la tabla Tipos de recursos incluye la columna Claves de condición, que son las claves de condición del recurso que se aplican a una acción de la tabla Acciones.

Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Acciones.

Acciones	Descripción	Nivel de acceso	Tipos de recursos (*necesarios)	Claves de condición	Acciones dependientes
AssociateCoupon [solo permiso]	Otorga permiso para asociar un DeepComposer cupón (o DSN) a la cuenta asociada al remitente de la solicitud	Escritura
CreateAudio [solo permiso]	Concede permiso para crear un archivo de audio convirtiendo la composición midi en un archivo wav o mp3	Write	audio*
CreateComposition [solo permiso]	Concede permiso para crear una composición midi de varias pistas	Write	composition*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateModel [solo permiso]	Concede permiso para comenzar a crear o entrenar un modelo generativo que sea capaz de realizar la inferencia según la melodía de piano proporcionada por el usuario para crear una composición midi de varias pistas	Write	model*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteComposition [solo permiso]	Concede permiso para eliminar la composición	Write	composition*
DeleteModel	Concede permiso para eliminar el modelo	Write	model*
GetComposition [solo permiso]	Concede permiso para obtener información acerca de la composición	Read	composition*
				aws:ResourceTag/${TagKey}
GetModel [solo permiso]	Concede permiso para obtener información acerca del modelo	Read	model*
				aws:ResourceTag/${TagKey}
GetSampleModel [solo permiso]	Otorga permiso para obtener información sobre el modelo de muestra DeepComposer o previamente entrenado	Leer	model*
ListCompositions [solo permiso]	Concede permiso para enumerar todas las composiciones propiedad del remitente de la solicitud	List	composition*
ListModels [solo permiso]	Concede permiso para enumerar todos los modelos propiedad del remitente de la solicitud	List	model*
ListSampleModels [solo permiso]	Otorga permiso para enumerar todos los modelos de muestra o preentrenados proporcionados por el servicio DeepComposer	Enumeración	model*
ListTagsForResource	Concede permiso para obtener una lista de etiquetas para un recurso.	List	composition
			model
				aws:ResourceTag/${TagKey}
ListTrainingTopics [solo permiso]	Concede permiso para enumerar todas las opciones de entrenamiento o tema para crear o entrenar un modelo	List	model*
TagResource	Concede permiso para etiquetar un recurso	Etiquetado	composition
			model
				aws:TagKeys aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey}
UntagResource	Concede permiso para eliminar etiquetas en un recurso	Etiquetado	composition
			model
				aws:TagKeys aws:ResourceTag/${TagKey}
UpdateComposition [solo permiso]	Concede permiso para modificar las propiedades mutables asociadas a una composición	Write	composition*
UpdateModel [solo permiso]	Concede permiso para modificar las propiedades mutables asociadas a un modelo	Escritura	model*

Tipos de recursos definidos por AWS DeepComposer

Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento Resource de las instrucciones de política de permisos de IAM. Cada acción de la tabla Acciones identifica los tipos de recursos que se pueden especificar con dicha acción. Un tipo de recurso también puede definir qué claves de condición se pueden incluir en una política. Estas claves se muestran en la última columna de la tabla Tipos de recursos. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Tipos de recurso.

Tipos de recurso	ARN	Claves de condición
model	arn:${Partition}:deepcomposer:${Region}:${Account}:model/${ModelId}	aws:ResourceTag/${TagKey}
composition	arn:${Partition}:deepcomposer:${Region}:${Account}:composition/${CompositionId}	aws:ResourceTag/${TagKey}
audio	arn:${Partition}:deepcomposer:${Region}:${Account}:audio/${AudioId}

Claves de condición de AWS DeepComposer

AWS DeepComposer define las siguientes claves de condición que se pueden utilizar en el Condition elemento de una política de IAM. Puede utilizar estas claves para ajustar más las condiciones en las que se aplica la instrucción de política. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla de Claves de condición.

Para ver las claves de condición globales que están disponibles para todos los servicios, consulte Claves de condición globales disponibles.

Claves de condición	Descripción	Tipo
aws:RequestTag/${TagKey}	Filtra el acceso mediante acciones en función de la presencia de pares de clave-valor de etiqueta en la solicitud.	Cadena
aws:ResourceTag/${TagKey}	Filtra el acceso mediante acciones en función de pares de clave-valor asociados al recurso.	Cadena
aws:TagKeys	Filtra el acceso mediante acciones en función de la presencia de claves de etiqueta en la solicitud	ArrayOfString