Compartir a través de

az afd origin

  • Referencia

Administrar orígenes dentro del grupo de origen especificado.

Comandos

Nombre Description Tipo Estado
az afd origin create

Cree un nuevo origen dentro del grupo de origen especificado.

 Core GA
az afd origin delete

Elimine un origen existente dentro de un grupo de orígenes.

 Core GA
az afd origin list

Enumere todos los orígenes existentes dentro de un grupo de origen.

 Core GA
az afd origin show

Obtener un origen existente dentro de un grupo de origen.

 Core GA
az afd origin update

Actualice un nuevo origen dentro del grupo de origen especificado.

 Core GA
az afd origin wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Core GA

az afd origin create

Cree un nuevo origen dentro del grupo de origen especificado.

az afd origin create --name
                     --origin-group-name
                     --profile-name
                     --resource-group
                     [--enable-private-link {0, 1, f, false, n, no, t, true, y, yes}]
                     [--enabled-state {Disabled, Enabled}]
                     [--enforce-certificate-name-check {0, 1, f, false, n, no, t, true, y, yes}]
                     [--host-name]
                     [--http-port]
                     [--https-port]
                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                     [--origin-host-header]
                     [--priority]
                     [--private-link-location]
                     [--private-link-request-message]
                     [--private-link-resource]
                     [--private-link-sub-resource-type]
                     [--weight]

Ejemplos

Creación de un origen normal

az afd origin create -g group --host-name example.contoso.com --profile-name profile --origin-group-name originGroup --origin-name origin1 --origin-host-header example.contoso.com --priority 1 --weight 500 --enabled-state Enabled --http-port 80 --https-port 443 - name: Create a private link origin

Creación de un origen de vínculo privado

az afd origin create -g group --host-name example.contoso.com --profile-name profile --origin-group-name originGroup --origin-name origin1 --origin-host-header example.contoso.com --priority 1 --weight 500 --enabled-state Enabled --http-port 80 --https-port 443 --private-link-resource /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group/providers/Microsoft.Storage/storageAccounts/plstest --private-link-location EastUS --private-link-request-message 'Please approve this request' --private-link-sub-resource-type table

Parámetros requeridos

--name --origin-name -n

Nombre del origen que es único dentro del perfil.

--origin-group-name

Nombre del grupo de origen que es único dentro del perfil.

--profile-name

Nombre del perfil de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--enable-private-link

Indica si el vínculo privado está enanble en ese origen.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Valor predeterminado: True
--enabled-state

Indica si se deben realizar sondeos de estado en los back-end definidos en backendPools. Los sondeos de estado solo se pueden deshabilitar si hay un solo back-end habilitado en un único grupo de back-end habilitado.

Valores aceptados: Disabled, Enabled
--enforce-certificate-name-check

Indica si se debe habilitar la comprobación del nombre del certificado en el nivel de origen.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Valor predeterminado: True
--host-name

Dirección del origen. Se admiten nombres de dominio, direcciones IPv4 e direcciones IPv6. Debe ser único en todos los orígenes de un punto de conexión.

--http-port

Valor del puerto HTTP. Debe estar entre 1 y 65535.

Valor predeterminado: 80
--https-port

Valor del puerto HTTPS. Debe estar entre 1 y 65535.

Valor predeterminado: 443
--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--origin-host-header

Valor del encabezado de host enviado al origen con cada solicitud. Si deja este valor en blanco, el nombre de host de la solicitud determina este valor. Los orígenes de Azure Front Door, como Web Apps, Blob Storage y Cloud Services requieren este valor de encabezado de host para que coincida con el nombre de host de origen de forma predeterminada. Esto invalida el encabezado de host definido en punto de conexión.

--priority

Prioridad del origen en un grupo de origen determinado para el equilibrio de carga. Las prioridades más altas no se usarán para el equilibrio de carga si algún origen de prioridad inferior es correcto. Debe estar entre 1 y 5.

--private-link-location

Ubicación de origen a la que se conectará mediante el vínculo privado.

--private-link-request-message

Mensaje que se muestra al aprobador de la solicitud de vínculo privado.

--private-link-resource

Identificador de recurso del origen al que se conectará mediante el vínculo privado.

--private-link-sub-resource-type

Tipo de subrecurso del origen al que se conectará mediante el vínculo privado. Puede usar "az network private-link-resource list" para obtener los tipos de subrecursos admitidos.

--weight

Peso del origen en un grupo de orígenes determinado para el equilibrio de carga. Debe estar entre 1 y 1000.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az afd origin delete

Elimine un origen existente dentro de un grupo de orígenes.

az afd origin delete [--ids]
                     [--name]
                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                     [--origin-group-name]
                     [--profile-name]
                     [--resource-group]
                     [--subscription]
                     [--yes]

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --origin-name -n

Nombre del origen que es único dentro del perfil.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--origin-group-name

Nombre del grupo de origen que es único dentro del perfil.

--profile-name

Nombre del perfil de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az afd origin list

Enumere todos los orígenes existentes dentro de un grupo de origen.

az afd origin list --origin-group-name
                   --profile-name
                   --resource-group
                   [--max-items]
                   [--next-token]

Parámetros requeridos

--origin-group-name

Nombre del grupo de origen que es único dentro del perfil.

--profile-name

Nombre del perfil de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token el argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az afd origin show

Obtener un origen existente dentro de un grupo de origen.

az afd origin show [--ids]
                   [--name]
                   [--origin-group-name]
                   [--profile-name]
                   [--resource-group]
                   [--subscription]

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --origin-name -n

Nombre del origen que es único dentro del perfil.

--origin-group-name

Nombre del grupo de origen que es único dentro del perfil.

--profile-name

Nombre del perfil de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az afd origin update

Actualice un nuevo origen dentro del grupo de origen especificado.

az afd origin update [--add]
                     [--enable-private-link {0, 1, f, false, n, no, t, true, y, yes}]
                     [--enabled-state {Disabled, Enabled}]
                     [--enforce-certificate-name-check {0, 1, f, false, n, no, t, true, y, yes}]
                     [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                     [--host-name]
                     [--http-port]
                     [--https-port]
                     [--ids]
                     [--name]
                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                     [--origin-group-name]
                     [--origin-host-header]
                     [--priority]
                     [--private-link-location]
                     [--private-link-request-message]
                     [--private-link-resource]
                     [--private-link-sub-resource-type]
                     [--profile-name]
                     [--remove]
                     [--resource-group]
                     [--set]
                     [--subscription]
                     [--weight]

Ejemplos

Actualice el encabezado de host y la prioridad del origen especificado.

az afd origin update -g group --host-name example.contoso.com --profile-name profile --origin-group-name originGroup --origin-name origin1 --origin-host-header example.contoso.com --priority 3

Deshabilite el vínculo privado del origen.

az afd origin update -g group --host-name example.contoso.com --profile-name profile --origin-group-name originGroup --origin-name origin1 --enable-private-link False

Parámetros opcionales

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string o JSON string>.

--enable-private-link

Indica si el vínculo privado está enanble en ese origen.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--enabled-state

Indica si se deben realizar sondeos de estado en los back-end definidos en backendPools. Los sondeos de estado solo se pueden deshabilitar si hay un solo back-end habilitado en un único grupo de back-end habilitado.

Valores aceptados: Disabled, Enabled
--enforce-certificate-name-check

Indica si se debe habilitar la comprobación del nombre del certificado en el nivel de origen.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--host-name

Dirección del origen. Se admiten nombres de dominio, direcciones IPv4 e direcciones IPv6. Debe ser único en todos los orígenes de un punto de conexión.

--http-port

Valor del puerto HTTP. Debe estar entre 1 y 65535.

--https-port

Valor del puerto HTTPS. Debe estar entre 1 y 65535.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --origin-name -n

Nombre del origen que es único dentro del perfil.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--origin-group-name

Nombre del grupo de origen que es único dentro del perfil.

--origin-host-header

Valor del encabezado de host enviado al origen con cada solicitud. Si deja este valor en blanco, el nombre de host de la solicitud determina este valor. Los orígenes de Azure Front Door, como Web Apps, Blob Storage y Cloud Services requieren este valor de encabezado de host para que coincida con el nombre de host de origen de forma predeterminada. Esto invalida el encabezado de host definido en punto de conexión.

--priority

Prioridad del origen en un grupo de origen determinado para el equilibrio de carga. Las prioridades más altas no se usarán para el equilibrio de carga si algún origen de prioridad inferior es correcto. Debe estar entre 1 y 5.

--private-link-location

Ubicación de origen a la que se conectará mediante el vínculo privado.

--private-link-request-message

Mensaje que se muestra al aprobador de la solicitud de vínculo privado.

--private-link-resource

Identificador de recurso del origen al que se conectará mediante el vínculo privado.

--private-link-sub-resource-type

Tipo de subrecurso del origen al que se conectará mediante el vínculo privado. Puede usar "az network private-link-resource list" para obtener los tipos de subrecursos admitidos.

--profile-name

Nombre del perfil de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--weight

Peso del origen en un grupo de orígenes determinado para el equilibrio de carga. Debe estar entre 1 y 1000.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az afd origin wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

az afd origin wait [--created]
                   [--custom]
                   [--deleted]
                   [--exists]
                   [--ids]
                   [--interval]
                   [--name]
                   [--origin-group-name]
                   [--profile-name]
                   [--resource-group]
                   [--subscription]
                   [--timeout]
                   [--updated]

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--name --origin-name -n

Nombre del origen que es único dentro del perfil.

--origin-group-name

Nombre del grupo de origen que es único dentro del perfil.

--profile-name

Nombre del perfil de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.