Trabajar con tipos de cambios de aprovisionamiento () CTs - Guía para desarrolladores de aplicaciones avanzadas de AMS
Compruebe si una tomografía computarizada existente cumple con sus requisitosSolicite un nuevo CTPruebe la nueva tomografía computarizada

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.

Trabajar con tipos de cambios de aprovisionamiento () CTs

AMS es responsable de su infraestructura gestionada. Para realizar cambios, debe enviar una RFC con la clasificación CT correcta (categoría, subcategoría, artículo y operación). En esta sección se describe cómo encontrar CTs, determinar si alguno es adecuado para sus necesidades y solicitar un nuevo CT si no lo es.

Compruebe si una tomografía computarizada existente cumple con sus requisitos

Una vez que haya determinado qué es lo que desea implementar con AMS, el siguiente paso es estudiar CTs las CloudFormation plantillas existentes para ver si ya existe una solución.

Al crear una RFC, debe especificar la CT. Puede utilizar la Consola de administración de AWS API/CLI de AMS. A continuación se describen ejemplos del uso de ambas.

Puede utilizar la consola o la API/CLI para buscar un identificador de tipo de cambio (CT) o una versión. Existen dos métodos: buscar o seleccionar la clasificación. Para ambos tipos de selección, puede ordenar la búsqueda eligiendo Usado con más frecuencia, Usado más recientemente o Alfabético.

YouTube Vídeo: ¿Cómo creo un RFC mediante la CLI de AWS Managed Services y dónde puedo encontrar el esquema CT?

En la consola AMS, en la página RFCs-> Crear RFC:

  • Con la opción Buscar por tipo de cambio seleccionada (opción predeterminada), puede hacer lo siguiente:

    • Usa el área de creación rápida para seleccionar una de las más populares de AMS CTs. Haga clic en una etiqueta y se abrirá la página Ejecutar RFC con la opción Asunto rellenada automáticamente. Complete las opciones restantes según sea necesario y haga clic en Ejecutar para enviar la RFC.

    • O bien, desplácese hacia abajo hasta el área Todos los tipos de cambios y comience a escribir un nombre de CT en el cuadro de opciones; no es necesario que tenga el nombre exacto o completo del tipo de cambio. También puede buscar una tomografía computarizada por ID de tipo de cambio, clasificación o modo de ejecución (automática o manual) introduciendo las palabras correspondientes.

      Con la vista de tarjetas predeterminada seleccionada, las tarjetas CT coincidentes aparecen a medida que escribes, seleccionas una carta y haces clic en Crear RFC. Con la vista de tabla seleccionada, elige el CT correspondiente y haz clic en Crear RFC. Ambos métodos abren la página Ejecutar RFC.

  • Como alternativa, y para explorar las opciones de tipos de cambio, haga clic en Elegir por categoría en la parte superior de la página para abrir una serie de cuadros de opciones desplegables.

  • Elija una categoría, una subcategoría, un elemento y una operación. Aparece el cuadro de información para ese tipo de cambio y aparece un panel en la parte inferior de la página.

  • Cuando esté listo, presione Entrar y aparecerá una lista de los tipos de cambios coincidentes.

  • Elige un tipo de cambio de la lista. El cuadro de información para ese tipo de cambio aparece en la parte inferior de la página.

  • Una vez que tenga el tipo de cambio correcto, elija Crear RFC.

nota

La CLI de AMS debe estar instalada para que estos comandos funcionen. Para instalar la API o CLI de AMS, vaya a la página de recursos para desarrolladores de la consola AMS. Para obtener material de referencia sobre la API AMS CM o la API AMS SKMS, consulte la sección Recursos de información de AMS en la Guía del usuario. Puede que necesite añadir una --profile opción de autenticación; por ejemplo,aws amsskms ams-cli-command --profile SAML. Es posible que también tengas que añadir la --region opción, ya que todos los comandos de AMS se ejecutan desde us-east-1, por ejemplo. aws amscm ams-cli-command --region=us-east-1

nota

Los puntos de enlace AMS API/CLI (amscm y amsskms) se encuentran en la región de AWS del Norte de Virginia,. us-east-1 En función de cómo esté configurada su autenticación y de la región de AWS en la que se encuentren su cuenta y sus recursos, es posible que tenga que --region us-east-1 añadirlos al emitir comandos. Es posible que también necesite añadirlo--profile saml, si ese es su método de autenticación.

Para buscar un tipo de cambio mediante la API CM de AMS (consulte ListChangeTypeClassificationSummaries) o la CLI:

Puede utilizar un filtro o una consulta para realizar la búsqueda. La ListChangeTypeClassificationSummaries operación tiene opciones de filtros para CategorySubcategory,Item, yOperation, pero los valores deben coincidir exactamente con los valores existentes. Para obtener resultados más flexibles al usar la CLI, puede usar la --query opción.

Cambie el tipo de filtrado con la API/CLI AMS CM
Atributo Valores válidos Condición válida/predeterminada Notas

ChangeTypeId

Cualquier cadena que represente a ChangeTypeId (por ejemplo: ct-abc123xyz7890)

Igual a

Para ver el tipo de cambio, consulte la Referencia del tipo de cambio. IDs

Para ver el tipo de cambio IDs, consulte Búsqueda de un tipo de cambio o CSIO.

Categoría

Cualquier texto de formato libre

Contiene

No se admiten las expresiones regulares en cada campo individual. Búsqueda sin distinción de mayúsculas y minúsculas

Subcategory

Elemento

Operation

  1. Estos son algunos ejemplos de clasificaciones de tipos de cambio de listas:

    El siguiente comando muestra todas las categorías de tipos de cambio.

    aws amscm list-change-type-categories

    El siguiente comando muestra las subcategorías que pertenecen a una categoría específica.

    aws amscm list-change-type-subcategories --category CATEGORY

    El siguiente comando muestra los elementos que pertenecen a una categoría y subcategoría especificadas.

    aws amscm list-change-type-items --category CATEGORY --subcategory SUBCATEGORY

  2. Estos son algunos ejemplos de búsqueda de tipos de cambios con consultas CLI:

    El siguiente comando busca en los resúmenes de las clasificaciones de CT las que contienen «S3" en el nombre del elemento y crea el resultado de la categoría, la subcategoría, el elemento, la operación y el identificador del tipo de cambio en forma de tabla. 

    aws amscm list-change-type-classification-summaries --query "ChangeTypeClassificationSummaries [?contains(Item, 'S3')].[Category,Subcategory,Item,Operation,ChangeTypeId]" --output table
    +---------------------------------------------------------------+
|               ListChangeTypeClassificationSummaries           |
+----------+-------------------------+--+------+----------------+
|Deployment|Advanced Stack Components|S3|Create|ct-1a68ck03fn98r|
+----------+-------------------------+--+------+----------------+

  3. A continuación, puede utilizar el identificador del tipo de cambio para obtener el esquema CT y examinar los parámetros. El siguiente comando envía el esquema a un archivo JSON denominado Creates3Params.schema.json.

    aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateS3Params.schema.json

    Para obtener información sobre el uso de consultas CLI, consulte Cómo filtrar la salida con la opción --query y la referencia del lenguaje de consulta, JMESPath Especificación.

  4. Una vez que tengas el ID del tipo de cambio, te recomendamos que compruebes la versión del tipo de cambio para asegurarte de que es la última. Usa este comando para buscar la versión de un tipo de cambio específico:

    aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CHANGE_TYPE_ID

    Para AutomationStatus buscar el tipo de cambio específico, ejecute este comando:

    aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"

    Para ExpectedExecutionDurationInMinutes buscar el tipo de cambio específico, ejecuta este comando:

    aws amscm --profile saml get-change-type-version --change-type-id ct-14027q0sjyt1h --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"

Una vez que hayas encontrado el CT que consideres apropiado, observa los parámetros de ejecución (esquema JSON) asociado al mismo para saber si se adapta a tu caso de uso.

Utilice este comando para generar un esquema CT en un archivo JSON que lleve el nombre del CT; este ejemplo genera el esquema de almacenamiento Create S3:

aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateBucketParams.json

Veamos más de cerca lo que ofrece este esquema.

Esquema de creación de cubos de S3 
{	
  "$schema": "http://json-schema.org/draft-04/schema#",
"name": "Create S3 Storage  
"description": "Use to create an Amazon Simple Storage Service stack.",
  "type": "object",
  "properties": {
    "Description": {
      "description": "The description of the stack.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "VpcId": {
      "description": "ID of the VPC to create the S3 Bucket in, in the form vpc-a1b2c3d4e5f67890e.",
      "type": "string",
      "pattern": "^vpc-[a-z0-9]{17}$"
    },
    "StackTemplateId": {
      "description": "Required value: stm-s2b72beb000000000.",
      "type": "string",
      "enum": ["stm-s2b72beb000000000"]
    },
    "Name":{
      "description": "The name of the stack to create.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "Tags": {
      "description": "Up to seven tags (key/value pairs) for the stack.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "Key": {
            "type": "string",
            "minLength": 1,
            "maxLength": 127
          },
          "Value": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255
          }
        },
        "additionalProperties": false,
        "required": [
          "Key",
          "Value"
        ]
      },
      "minItems": 1,
      "maxItems": 7
    },
    "TimeoutInMinutes": {
      "description": "The amount of time, in minutes, to allow for creation of the stack.",
      "type": "number",
      "minimum": 0,
      "maximum": 60
    },
    "Parameters": {
      "description": "Specifications for the stack.",
      "type": "object",
      "properties": {
        "AccessControl": {
          "description": "The canned (predefined) access control list (ACL) to assign to the bucket.",
          "type": "string",
          "enum": [
            "Private",
            "PublicRead",
            "AuthenticatedRead",
            "BucketOwnerRead"
          ]
        },
        "BucketName": {
          "description": "A name for the bucket. The bucket name must contain only lowercase letters, numbers, periods (.), and hyphens (-).",
          "type": "string",
          "pattern": "^[a-z0-9]([-.a-z0-9]+)[a-z0-9]$",
          "minLength": 3,
          "maxLength": 63
        }
      },
      "additionalProperties": false,
      "required": [
        "AccessControl",
        "BucketName"
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "Description",
    "VpcId",
    "StackTemplateId",
    "Name",
    "TimeoutInMinutes",
    "Parameters"
  ]
}

El esquema comienza con la CT («descripción»), que indica para qué sirve el esquema. En este caso, para crear una pila de almacenamiento de S3.

A continuación, tiene propiedades obligatorias y opcionales que puede especificar. Se proporcionan los valores de propiedad predeterminados. Las propiedades obligatorias se muestran al final del esquema.

En el StackTemplateId área, verá que hay una plantilla de pila específica para este CT y este esquema, y su identificador es un valor de propiedad obligatorio.

El esquema le permite etiquetar la pila que está creando para fines de contabilidad interna. Además, algunas opciones, como la copia de seguridad, requieren una etiqueta de Key:Backup y Value:True. Para obtener información detallada, consulta Cómo etiquetar tus EC2 recursos de Amazon.

En la sección de parámetros del esquema CT JSON se proporcionan los parámetros de ejecución.

Para este esquema, solo se requieren la ACL y BucketName los parámetros de ejecución.

Solicite un nuevo CT

Tras examinar el esquema, puede decidir que no proporciona parámetros suficientes para crear la implementación que desea. Si ese es el caso, examine las CloudFormation plantillas existentes para encontrar una que se acerque más a lo que desea. Una vez que sepa qué parámetros adicionales necesita, envíe un documento de administración | Otros | Otros | Crear CT.

nota

Todos los demás | Other Create and Update CTs reciben la atención de un operador de AMS, quien se pondrá en contacto con usted para hablar sobre el nuevo CT.

Para enviar una solicitud de un nuevo CT, acceda a la consola AMS de forma habitual Consola de administración de AWSy, a continuación, siga estos pasos.

  1. En el panel de navegación de la izquierda, haz clic en RFCs.

    Se abre la página RFCs del panel de control.

  2. Haga clic en Crear.

    Se abre la página Crear una solicitud de cambio.

  3. Seleccione Administración en la lista desplegable de categorías y Otros para la subcategoría y el artículo. Para la operación, elija Crear. La RFC necesitará aprobación antes de poder implementarse.

  4. Introduzca la información que explique por qué desea el CT, por ejemplo: solicite un CT de almacenamiento Create S3 modificado que permita personalizarlo ACLs, en función del CT de almacenamiento Create S3 existente. Esto debería dar como resultado un nuevo CT: Deployment | Advanced Stack Components | S3 storage | Create S3 custom ACL. Este nuevo CT podría ser público.

  5. Haga clic en Submit.

    Su RFC aparece en el panel de control de RFC.

Pruebe la nueva tomografía computarizada

Una vez que AWS Managed Services haya creado ese nuevo CT, debe probarlo enviando un RFC con él. Si ha colaborado con AMS para aprobar previamente el nuevo CT, solo tiene que seguir una solicitud de RFC estándar y observar el resultado (para obtener más información sobre el envío RFCs, consulte Creación y envío de una RFC). Si el nuevo CT no está aprobado previamente (quiere asegurarse de que nunca se ejecute sin una aprobación explícita), tendrá que hablar con AMS sobre su implementación cada vez que desee publicarlo.