Invocar el servicio RESTInvoke REST Service

Se aplica a: System Center 2016 - OrchestratorApplies To: System Center 2016 - Orchestrator

La actividad invocar servicio de REST se utiliza en un runbook para realizar solicitudes a los servicios web RESTful y recuperar datos o ejecutar funciones.The Invoke REST Service activity is used in a runbook to make requests to RESTful web services and retrieve data or execute functions.

La actividad publica todos los datos de las propiedades necesarias y opcionales en los datos publicados.The activity publishes all of the data from the required and optional properties into published data. Las tablas siguientes enumeran las propiedades necesarias y opcionales y los datos publicados para esta actividad.The following tables list the required and optional properties and published data for this activity.

Invocar el resto propiedades necesarias de servicioInvoke REST Service Required Properties

ElementoElement DescripciónDescription Valores válidosValid Values
Versión de HTTPHTTP Version La versión de HTTP va a utilizar.The version of HTTP to use. 1.0, 1.11.0, 1.1
Método HTTPHTTP Method Método HTTP que se usará.The HTTP method to use. Los métodos HTTP admitidos son GET, PUT, POST y DELETEThe supported HTTP methods are GET, PUT, POST, and DELETE
Dirección URLURL La dirección URL a la utilice.The URL to use. Una dirección URL válidaAny valid URL
Codificar la dirección URLEncode URL Si desea o no codifica la dirección URL.Whether or not to encode the URL. Es true, FalseTrue, False
Tiempo de esperaTimeout El tiempo máximo para esperar una respuesta.The maximum time to wait for a response. Entero positivoPositive integer
Tipo de autenticaciónAuthentication Type El esquema de autenticación que se usará al conectarse al servicio REST.The authentication scheme to use when connecting to the REST service. Default, Basic, Negotiate, implícitaDefault, Basic, Negotiate, Digest
Acepte el certificado no es válidoAccept Invalid Certificate Al usar HTTPS, establezca este modificador en True para aceptar un certificado de servidor no válido o establézcala en False no lo acepta.When using HTTPS, set this switch to True to accept an invalid server certificate or set it to False to not accept it. True o FalseTrue or False
DominioDomain El dominio que se usará para la autenticación.The domain to use for authentication. Cadena.String. Puede estar en blanco.Can be blank.
usuarioUser El nombre de usuario que se utilizará para la autenticación.The user name to use for authentication. Cadena.String. Puede estar en blanco.Can be blank.
ContraseñaPassword La contraseña que se utilizará para la autenticación.The password to use for authentication. Cadena.String. Se pueden cifrar.Can be encrypted. Puede estar en blanco.Can be blank.
Encabezado de solicitudRequest Header Encabezados de solicitud especial especificados en este formato:Special request headers entered in this format:
<Parámetro>: <Valor><Parameter>: <Value>
Los parámetros válidos del encabezado de solicitud HTTP y valores.Valid HTTP request header parameters and values. Puede estar en blanco.Can be blank.
Cada parámetro: par de valor debe estar en una línea independiente.Each parameter: value pair must be on a separate line.
Cuerpo de la solicitudRequest Body El cuerpo de la solicitud.The request body. Si no está en blanco, a continuación, ruta de acceso de carga de archivos debe estar en blanco.If not blank, then Payload File Path must be blank. Cadena.String. Puede estar en blanco.Can be blank.
Ruta de acceso de archivo de cargaPayload File Path La ubicación del archivo de carga para usar con la solicitud.The location of the payload file to use with the request. Si no está en blanco, cuerpo de solicitud debe estar en blanco.If not blank, Request Body must be blank. Una ubicación de archivo válido.A valid file location. Puede estar en blanco.Can be blank.
Ruta de acceso del archivo PFXPFX File Path La ubicación del archivo del certificado de cliente cifrado usado para las solicitudes en Windows Azure.The location of the encrypted client certificate file used for requests to Windows Azure. Una ubicación de archivo válido.A valid file location. Puede estar en blanco.Can be blank.
Contraseña del archivo PFXPFX File Password La contraseña para el cifrado archivo ini. Formato PFX.The password to the encrypted file ini .PFX format. Cadena.String. Se pueden cifrar.Can be encrypted. Puede estar en blanco.Can be blank.

Invocar propiedades opcionales del servicio RESTInvoke REST Service Optional Properties

No hay ninguna propiedad opcional para esta actividad.There are no optional properties for this activity.

Invocación de REST de servicio de datos publicadosInvoke REST Service Published Data

ElementoElement DescripciónDescription Tipo de valorValue type
Acepte el certificado no es válidoAccept Invalid Certificate Al usar HTTPS, establezca este modificador en True para aceptar un certificado de servidor no válido o establézcala en False no lo acepta.When using HTTPS, set this switch to True to accept an invalid server certificate or set it to False to not accept it. BooleanBoolean
Tipo de autenticaciónAuthentication Type El esquema de autenticación que se usará al conectarse al servicio REST.The authentication scheme to use when connecting to the REST service. StringString
Codificar la dirección URLEncode URL Si desea o no codifica la dirección URL.Whether or not to encode the URL. BooleanBoolean
Método HTTPHTTP Method Método HTTP que se usará.The HTTP method to use. StringString
Versión de HTTPHTTP Version La versión de HTTP va a utilizar.The version of HTTP to use. StringString
Ruta de acceso del archivo PFXPFX File Path La ubicación del archivo del certificado de cliente cifrado usado para las solicitudes en Windows Azure.The location of the encrypted client certificate file used for requests to Windows Azure. StringString
Ruta de acceso de archivo de cargaPayload File Path La ubicación del archivo de carga para usar con la solicitud.The location of the payload file to use with the request. Si no está en blanco, cuerpo de solicitud debe estar en blanco.If not blank, Request Body must be blank. StringString
Cuerpo de la solicitudRequest Body El cuerpo de la solicitud.The request body. Si no está en blanco, a continuación, ruta de acceso de carga de archivos debe estar en blanco.If not blank, then Payload File Path must be blank. StringString
Encabezado de solicitudRequest Header Encabezados de solicitud especial especificados en este formato:Special request headers entered in this format:
<Parámetro>: <Valor><Parameter>: <Value>
StringString
Cookies de respuestaResponse Cookies Cookies de respuesta HTTP.HTTP response cookies. Cadena con formato de cookies de respuesta HTTPString in HTTP response cookie format
Encabezado de respuestaResponse Header Encabezado de respuesta HTTP.HTTP response header. Cadena con formato de encabezado de respuesta HTTPString in HTTP response header format
Cuerpo del mensaje de respuestaResponse Message Body Cuerpo del mensaje de respuesta HTTP.HTTP response message body. Cadena con formato de mensaje de respuesta HTTPString in HTTP response message format
Código de estado de respuestaResponse Status Code El código de estado de respuesta (por ejemplo, 200).The response status code (for example, 200). Un código de estado de respuesta válidoA valid response status code
Línea de estado de respuestaResponse Status Line La línea de estado de respuesta.The response status line. Una línea de estado de respuesta válidoA valid response status line
Tiempo de esperaTimeout El tiempo máximo para esperar una respuesta.The maximum time to wait for a response. IntegerInteger
Dirección URLURL La dirección URL a la utilice.The URL to use. StringString