View a markdown version of this page

Acciones, recursos y claves de condición para AWS servicios - Referencia de autorizaciones de servicio

Acciones, recursos y claves de condición para AWS servicios

Cada AWS servicio puede definir las operaciones, las acciones, los recursos y las claves de contexto de las condiciones de la API para utilizarlas en las políticas de IAM. En este tema se describe cómo se documentan los elementos proporcionados para cada servicio.

Cada tema consta de tablas que proporcionan la lista de operaciones, acciones, recursos y claves de condición disponibles.

La tabla de operaciones

La tabla de operaciones muestra las operaciones de la API definidas por el servicio y asigna cada una de ellas a las acciones de IAM que las autorizan. Una sola operación puede autorizar más de una acción de IAM. Algunos servicios aún no tienen una tabla de operaciones. Esto no significa que no haya operaciones para ese servicio. Esta tabla aún no incluye las acciones que los servicios descendentes autorizan mediante sesiones de acceso directo.

  • La columna Operación muestra el nombre de la operación de la API. Cuando una operación autoriza varias acciones, el nombre de la operación abarca todas las filas de todas sus acciones autorizadas.

  • La columna de acciones de IAM muestra cada acción de IAM autorizada por la operación, en el formulario. service:ActionName Cuando la acción pertenece al mismo servicio que la operación, la entrada enlaza con la fila de esa acción en la tabla Acciones de la misma página. Cuando la acción pertenece a un servicio diferente, la entrada enlaza con la página de referencia de autorizaciones de ese servicio.

  • Las columnas Clave de condición y Valores posibles muestran solo las claves de condición que esta operación establece en un valor fijo y conocido al autorizar esta acción, junto con el valor que establece. Este no es el conjunto completo de claves de condición que pueden estar disponibles durante la autorización. Las claves que se muestran son las que tienen valores determinados estáticamente por la propia API. Para ver el conjunto completo de claves de condición que admite la acción, consulta la tabla Acciones y la tabla Claves de condición en la misma página.

  • La columna Nivel de acceso muestra la clasificación del nivel de acceso de la acción autorizada. Para obtener más información sobre los niveles de acceso, consulte Descripción de los resúmenes de nivel de acceso en los resúmenes de políticas.

Tabla Acciones

La tabla Actions (Acciones) muestra todas las acciones que puede utilizar en un elemento Action de la declaración de política de IAM. Algunos servicios incluyen acciones exclusivas que no corresponden directamente con una operación de la API. Estas acciones se enumeran en una tabla de Permission-only acciones independiente en la misma página. Utilice estas tablas para determinar qué acciones puede utilizar en una política de IAM. Para obtener más información sobre los elementos Action, Resource o Condition, consulte Referencia de los elementos de las políticas JSON de IAM. Las columnas Actions (Acciones) y Description (Descripción) de la tabla son descriptivas.

  • La columna Access level (Nivel de acceso) describe cómo se clasifica la acción (Lista, lectura, escritura, administración de permisos o etiquetado). Esta clasificación puede ayudarle a entender el nivel de acceso que una acción concede cuando se utiliza en una política. Para obtener más información sobre los niveles de acceso, consulte Descripción de los resúmenes de nivel de acceso en los resúmenes de políticas.

  • La columna Resource types (Tipos de recurso) indica si la acción admite permisos de nivel de recursos. Si la columna está vacía, la acción no admite permisos de nivel de recursos y debe especificar todos los recursos ("*") en su política. Si la columna incluye un tipo de recurso, puede especificar el ARN del recurso en el elemento Resource de la política. Para obtener más información acerca de dicho recurso, consulte esa fila en la tabla Resource types (Tipos de recurso). Todas las acciones y los recursos que se incluyen en una declaración deben ser compatibles entre sí. Si especifica un recurso que no es válido para la acción, cualquier solicitud de uso de dicha acción dará error y el Effect de la declaración no se aplica.

    Los recursos necesarios se indican en la tabla con un asterisco (*). Si especifica un ARN de permiso de recursos en una instrucción mediante esta acción, deberá ser de este tipo. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno pero no el otro.

  • La columna Condition keys (Claves de condición) incluye claves que puede especificar en el elemento Condition de una instrucción de política. Las claves de condición pueden ser compatibles con una acción o con una acción y un recurso específico. Preste especial atención a si la clave está en la misma fila que un tipo de recurso específico. Esta tabla no incluye las claves de condición globales que están disponibles para cualquier acción o en circunstancias no relacionadas. Para obtener más información sobre las claves de condición globales, consulte las claves de condición AWS globales.

Tabla Tipos de recurso

La tabla Resource types (Tipos de recurso) muestra todos los tipos de recursos que puede especificar como ARN en el elemento de política Resource. No todos los tipos de recursos se pueden especificar con cada acción. Algunos tipos de recursos funcionan solo con determinadas acciones. Para obtener más información sobre el elemento Resource, consulte Elementos de las políticas JSON de IAM: Recourse.

  • La columna ARN especifica el formato de nombre de recurso de Amazon (ARN) que debe utilizar para hacer referencia a los recursos de este tipo. Las partes precedidas por $ deben sustituirse por los valores reales de su escenario. Por ejemplo, si se observa $user-name en un ARN, se debe reemplazar esa cadena con el nombre de usuario real o una variable de política que contenga un nombre de usuario. Para obtener más información sobre los ARN, consulte ARN de IAM.

  • La columna Condition keys (Claves de condición) especifica las claves de contexto de condiciones que puede incluir en una instrucción de política de IAM solo cuando se incluyen en la instrucción este recurso y una acción de apoyo de la tabla anterior.

Tabla Claves de condición

En la tabla de claves de condición se enumeran todas las claves de condición que se pueden utilizar en el Condition elemento de una declaración de política de IAM. No todas las claves se pueden especificar con cada acción o recurso. Algunas solo funcionan con determinados tipos de acciones y recursos. Para obtener más información sobre el elemento Condition, consulte Elementos de las políticas JSON de IAM: Condition.

  • La columna Type (Tipo) especifica el tipo de datos de la clave de condición. Este tipo de datos determina qué operadores de condición puede usar para comparar los valores de la solicitud con los valores de la instrucción de política. Debe utilizar un operador que sea adecuado para el tipo de datos. Si utiliza un operador incorrecto, no habrá coincidencias y la declaración de política no se aplica.

    Si la columna Tipo especifica "ArrayOf..» uno de los tipos simples, debe utilizar operadores de conjuntos multivalor en sus políticas. Utilice el prefijo ForAllValues para especificar que todos los valores de la solicitud deben coincidir con un valor de la instrucción de política. Utilice el prefijo ForAnyValue para especificar que al menos un valor de la solicitud debe coincidir con uno de los valores de la instrucción de política.

Temas