Gestión de Alibaba Cloud CDN con la CLI - CDN - Centro de documentación de Alibaba Cloud

Alibaba Cloud CLI es una herramienta unificada de línea de comandos basada en OpenAPI Explorer que permite automatizar la gestión y el mantenimiento de Alibaba Cloud CDN. Este tema describe cómo instalar, configurar y utilizar Alibaba Cloud CLI para invocar operaciones de la API de Alibaba Cloud CDN.

Requisitos previos

Antes de empezar, familiarícese con Alibaba Cloud CLI. Para obtener más información, consulte What is Alibaba Cloud CLI?

Instalación de Alibaba Cloud CLI

Instale Alibaba Cloud CLI para su sistema operativo antes de comenzar.

Como alternativa, puede utilizar Cloud Shell para depurar comandos de Alibaba Cloud CLI sin necesidad de una instalación local. Para obtener más información, consulte What is Cloud Shell?.

Configuración de Alibaba Cloud CLI

Importante

Una cuenta de Alibaba Cloud (cuenta raíz) tiene acceso administrativo completo a sus servicios y recursos, lo que representa un riesgo de seguridad significativo. Se recomienda encarecidamente crear y utilizar un usuario de RAM para el acceso a la API o para las tareas diarias de operación y mantenimiento.

Configure sus credenciales de identidad y un ID de región antes de utilizar Alibaba Cloud CLI. Alibaba Cloud CLI admite diversos tipos de credenciales. Para obtener más información, consulte Configure and manage identity credentials. Este tema utiliza credenciales AccessKey (AK) como ejemplo.

Cree un usuario de RAM y otorgue los permisos obligatorios. Para obtener más información, consulte Create a RAM user y Grant permissions to a RAM user.

Importante
Este ejemplo requiere que asocie la directiva AliyunCDNReadOnlyAccess al usuario de RAM. También puede asociar la directiva AliyunCDNFullAccess, que otorga control total para consultar y modificar nombres de dominio de Alibaba Cloud CDN, o bien crear una directiva personalizada. Para obtener más información, consulte CDN custom policy reference.
Después de crear y autorizar al usuario de RAM, cree un par de AccessKey. Registre el AccessKey ID y el AccessKey Secret. Para obtener más información, consulte Create an AccessKey.
Obtenga y registre un ID de región disponible. Alibaba Cloud CLI envía solicitudes de API a la región que usted especifique. Para consultar la lista de regiones disponibles, véase Request structure.

Nota
Puede utilizar la opción --region para especificar una región en un comando. Esta opción anula la región predeterminada configurada en sus credenciales y variables de entorno. Para obtener más información, consulte Command-line options.
Utilice el par de AccessKey del usuario de RAM para configurar las credenciales. Asigne al perfil de configuración el nombre AkProfile. Para obtener más información, consulte Endpoints.

Generación de un ejemplo de comando de CLI

Vaya a la página de Debugging de la API de Alibaba Cloud CDN.
En el left-side search box, busque la API que desea utilizar. En la pestaña Parameters, configure los parámetros según la documentación de la API. Haga clic en la pestaña CLI Example para generar un ejemplo de comando con los parámetros configurados.
- Haga clic en el icono para abrir Cloud Shell y depurar el comando.
- Haga clic en el icono para copiar el ejemplo de CLI. A continuación, péguelo en su shell local para ejecutar el comando.
  - Al pegar el ejemplo en su shell local, compruebe el formato de los parámetros. Para obtener más información, consulte Understand command parameters.
  - De forma predeterminada, OpenAPI Explorer añade la opción --region al ejemplo generado. Esta opción anula la región predeterminada en la configuración de sus credenciales y en las variables de entorno. Elimínela o consérvela según sea necesario.

Invocación de una operación de API

Estructura del comando

Los comandos de Alibaba Cloud CLI siguen esta estructura. Para obtener más información, consulte Generate and call a command.

aliyun <command> <subcommand> [options and parameters]

Opciones comunes de línea de comandos

Utilice opciones de línea de comandos para modificar el comportamiento predeterminado de un comando. Las opciones comunes incluyen:

--profile <profileName>: Especifica un perfil de credenciales para usar en lugar del predeterminado. Cuando se establece, Alibaba Cloud CLI ignora la configuración de credenciales predeterminada y las variables de entorno.
--help: Muestra información de ayuda para un comando. Para obtener más información, consulte Get help information.

Para obtener más información, consulte Command-line options.

Ejemplo

El siguiente ejemplo invoca la operación DescribeUserDomains para consultar todos los nombres de dominio y sus estados bajo su cuenta. Para obtener más información, consulte DescribeUserDomains.

Ejecute el comando.

aliyun cdn DescribeUserDomains --DomainName mxxxio.top

El comando devuelve la siguiente salida.

{
  "Domains": {
    "PageData": [
      {
        "CdnType": "web",
        "Cname": "mxxx.xxxp.w.kunlunq.com",
        "Coverage": "domestic",
        "Description": "",
        "DomainId": 201xxx553,
        "DomainName": "mjlxxxao.top",
        "DomainStatus": "online",
        "GlobalResourcePlan": "off",
        "GmtCreated": "2024-08-27T06:29:36Z",
        "GmtModified": "2024-08-27T06:34:04Z",
        "ResourceGroupId": "rg-acfmwpdflelaoai",
        "Sandbox": "",
        "Sources": {
          "Source": [
            {
              "Content": "183.xxx.xxx.88.cn-hangzhou.sae.aliyuncs.com",
              "Port": 80,
              "Priority": "20",
              "Type": "domain",
              "Weight": "10"
            }
          ]
        }
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 20,
  "RequestId": "E4EBD2BF-5EB0-4044-9B97-xxxxxx",
  "TotalCount": 1
}
            }
          ]
        },
        "SslProtocol": "off"
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 20,
  "RequestId": "34C9E61F-02A0-5EB5-BBCB-16B531ABB9E0",
  "TotalCount": 1
}

Nota

Si una llamada a la API de Alibaba Cloud CDN devuelve un error, revise el código de error para comprobar que los parámetros y valores de su solicitud sean correctos.

También puede utilizar el RequestId o el mensaje de error del SDK de la respuesta con Alibaba Cloud OpenAPI Diagnostics para solucionar el problema.