View a markdown version of this page

AWSSupport-RequestSageMakerLimitIncrease - AWS Systems Manager Referencia del manual de automatización

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.

AWSSupport-RequestSageMakerLimitIncrease

Descripción

El AWSSupport-RequestSageMakerLimitIncrease manual permite el envío masivo de múltiples solicitudes de aumento de cuota de Amazon SageMaker AI (SageMaker AI) en una sola operación, lo que agiliza la gestión de cuotas para cargas de trabajo de aprendizaje automático a gran escala. El manual valida cada solicitud comparándola con cuotas de servicio de SageMaker IA ajustables, direcciona las solicitudes dentro de los umbrales de aprobación automática para su procesamiento inmediato y crea casos de AWS Support para las solicitudes que requieren una revisión manual. Los aumentos de cuota se aplican en la misma AWS región en la que se ejecuta el manual.

importante

Este manual no admite solicitudes de aumento de cuota para instancias informáticas especializadas, incluidos los tipos de instancias P4, P5 y Trainium. Para estos tipos de instancias, envía solicitudes de aumento de cuota individuales a través de la consola AWS Service Quotas o AWS Support.

El manual se detiene durante un máximo de una hora mientras espera la aprobación de los directores designados mediante una notificación del Amazon Simple Notification Service (Amazon SNS). Revise detenidamente el resultado del ApproveQuotaCodeLimitMapping paso antes de aprobarlo, ya que los aumentos de cuota aprobados no se pueden revertir.

Ejecuta esta automatización (consola)

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

Linux, macOS, Windows

Parámetros

  • AutomationAssumeRole

    Tipo AWS::IAM::Role: :Arn

    Descripción: (opcional) El nombre del recurso de Amazon (ARN) del rol AWS Identity and Access Management (IAM) que permite a (Systems AWS Systems Manager Manager) Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.

  • ResourcesMapping

    Tipo: StringList

    Descripción: (Obligatorio) Se aumentarán las cuotas de los servicios de SageMaker IA, especificadas como valores separados por dos puntos. Soporta tres formatos:

    • Category:Resource:NewValue— cuando están disponibles los nombres de las categorías y de los recursos. Ejemplo: spot-training-job:ml.c4.xlarge:25

    • Resource:NewValue— cuando solo está disponible el nombre del recurso. Ejemplo: max_number_of_experiment_trial_associations:501

    • QuotaCode:NewValue— cuando se utiliza el código de cuota directa. Ejemplo: L-9xAxx23x:25

    Puedes mezclar formatos en la misma solicitud, separados por comas. Máximo 50 artículos. Ejemplo: studio:CodeEditor-ml.r6id.large:787,spot-training-job:ml.c4.xlarge:34,L-99AEC235:2

  • SNSTopicArn

    Tipo: cadena

    Descripción: (obligatorio) El ARN del tema Amazon SNS utilizado para enviar las notificaciones de aprobación durante la ejecución de la automatización.

  • ApproverIAM

    Tipo: StringList

    Descripción: (Obligatoria) Una lista de directores AWS autenticados que pueden aprobar o rechazar las solicitudes de aumento de cuota. Máximo 10 aprobadores. Formatos aceptados: nombre de usuario de IAM, ARN de usuario de IAM, ARN de rol de IAM o ARN de usuario de rol de IAM.

  • MinimumRequiredApprovals

    Tipo: entero

    Valores válidos: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10

    Valor predeterminado: 1

    Descripción: (opcional) El número mínimo de aprobaciones necesarias para reanudar la automatización. No puede superar el número de aprobadores definido en. ApproverIAM

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

  • servicequotas:ListServiceQuotas

  • servicequotas:RequestServiceQuotaIncrease

  • servicequotas:GetRequestedServiceQuotaChange

  • sns:Publish

  • ssm:SendAutomationSignal

Pasos de documentos

  1. VerifyCategoriesAndResources- Valida todas las categorías y los recursos especificados comparándolos con las cuotas de servicio de SageMaker IA ajustables mediante la API AWS Service Quotas. Confirma que cada nombre de categoría y recurso existe y se puede modificar, e identifica las solicitudes en las que el nuevo límite es inferior al valor actual.

  2. BranchOnValidCategoriesFound- Comprueba si se ha encontrado alguna asignación de cuotas válida. Si existen asignaciones válidas, continúa con. ApproveQuotaCodeLimitMapping De lo contrario, salta directamente a. GenerateSummaryReport

  3. ApproveQuotaCodeLimitMapping- Prepara un mensaje de aprobación detallado en el que se muestran las solicitudes válidas listas para su procesamiento, las solicitudes no válidas con explicaciones (por ejemplo, límites inferiores a los valores actuales o códigos de cuota no admitidos) y un desglose completo de todas las solicitudes de aumento de cuota para su revisión antes de su aprobación.

  4. WaitingForApproval- Detiene la automatización y envía una notificación de aprobación al tema de Amazon SNS especificado. Los aprobadores designados deben revisar el resultado del ApproveQuotaCodeLimitMapping paso y aprobar o rechazar las solicitudes. Este paso se agota después de 3600 segundos (una hora) si no se realiza ninguna acción.

  5. RequestQuotaIncreases- Envía solicitudes individuales de aumento de cuota para cada recurso válido a través de la API AWS Service Quotas. El ritmo de las solicitudes es de una por segundo para evitar la limitación de la API. Maneja las excepciones de la API con reintentos exponenciales.

  6. WaitForRequestQuotaIncreaseResults- Consulta el estado de todas las solicitudes de aumento de cuota enviadas hasta que no quede ninguna en PENDING ese estado. Los estados de los terminales aceptados son CASE_OPENEDAPPROVED,DENIED, NOT_APPROVEDCASE_CLOSED, yINVALID_REQUEST.

  7. GetRequestQuotaIncreaseResults- Recupera el estado final de todas las solicitudes de aumento de cuota enviadas desde la API AWS Service Quotas y asigna el caso de soporte IDs a sus recursos y solicitudes de informes IDs correspondientes.

  8. GenerateSummaryReport- Recopila un resumen completo de todas las solicitudes de aumento de cuota y sus resultados, que incluye el número total de solicitudes, los detalles de cada solicitud, los casos de soporte IDs para las solicitudes que requieren una revisión manual y los próximos pasos a seguir.

Salidas

GenerateSummaryReport.SummaryReport- Un resumen completo de todas las solicitudes de aumento de cuota, sus estados y cualquier caso de soporte IDs creado para su revisión manual.