Desvinculación de políticas de control de acceso
Función
Esta API se utiliza para desvincular varias políticas de control de acceso de las API.
URI
PUT /v2/{project_id}/apigw/instances/{instance_id}/acl-bindings
| 
        Parámetro  | 
      
        Obligatorio  | 
      
        Tipo  | 
      
        Descripción  | 
     
|---|---|---|---|
| 
        project_id  | 
      
        Sí  | 
      
        String  | 
      
        ID del proyecto. Para obtener detalles sobre cómo obtener un ID de proyecto, consulte "Apéndice" > "Obtención de un ID de proyecto" en este documento.  | 
     
| 
        instance_id  | 
      
        Sí  | 
      
        String  | 
      
        Gateway ID, que se puede obtener de la información de gateway en la consola APIG.  | 
     
| 
        Parámetro  | 
      
        Obligatorio  | 
      
        Tipo  | 
      
        Descripción  | 
     
|---|---|---|---|
| 
        action  | 
      
        Sí  | 
      
        String  | 
      
        El valor debe ser borrado.  | 
     
Parámetros de solicitud
| 
        Parámetro  | 
      
        Obligatorio  | 
      
        Tipo  | 
      
        Descripción  | 
     
|---|---|---|---|
| 
        X-Auth-Token  | 
      
        Sí  | 
      
        String  | 
      
        Token de usuario. Se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es un token.  | 
     
| 
        Parámetro  | 
      
        Obligatorio  | 
      
        Tipo  | 
      
        Descripción  | 
     
|---|---|---|---|
| 
        acl_bindings  | 
      
        No  | 
      
        Array of strings  | 
      
        ID de los registros de enlace de política de control de acceso que se van a cancelar.  | 
     
Parámetros de respuesta
Código de estado: 200
| 
        Parámetro  | 
      
        Tipo  | 
      
        Descripción  | 
     
|---|---|---|
| 
        success_count  | 
      
        Integer  | 
      
        Número de políticas de control de acceso que se han desvinculado correctamente.  | 
     
| 
        failure  | 
      
        Array of AclBindingBatchFailure objects  | 
      
        Mensaje de error y políticas de control de acceso que no son independientes.  | 
     
| 
        Parámetro  | 
      
        Tipo  | 
      
        Descripción  | 
     
|---|---|---|
| 
        bind_id  | 
      
        String  | 
      
        ID de un registro de enlace de política de control de acceso que no se cancela.  | 
     
| 
        error_code  | 
      
        String  | 
      
        Código de error.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Mensaje de error.  | 
     
| 
        api_id  | 
      
        String  | 
      
        ID de una API desde la que falla la desvinculación.  | 
     
| 
        api_name  | 
      
        String  | 
      
        Nombre de la API desde la que falla la desvinculación.  | 
     
Código de estado: 400
| 
        Parámetro  | 
      
        Tipo  | 
      
        Descripción  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Código de error.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Mensaje de error.  | 
     
Código de estado: 401
| 
        Parámetro  | 
      
        Tipo  | 
      
        Descripción  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Código de error.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Mensaje de error.  | 
     
Código de estado: 403
| 
        Parámetro  | 
      
        Tipo  | 
      
        Descripción  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Código de error.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Mensaje de error.  | 
     
Código de estado: 404
| 
        Parámetro  | 
      
        Tipo  | 
      
        Descripción  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Código de error.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Mensaje de error.  | 
     
Código de estado: 500
| 
        Parámetro  | 
      
        Tipo  | 
      
        Descripción  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Código de error.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Mensaje de error.  | 
     
Solicitudes de ejemplo
{
  "acl_bindings" : [ "332c5db1458a477b89b2ea741fec94a3" ]
}
 Ejemplo de respuestas
Código de estado: 200
OK
{
  "failure" : [ {
    "bind_id" : "3a68d39f115d4c128fccd6f624ea6109",
    "error_code" : "APIG.3010",
    "error_msg" : "The access control policy binding record does not exist"
  } ],
  "success_count" : 1
}
  Código de estado: 400
Bad Request
{
  "error_code" : "APIG.2011",
  "error_msg" : "Invalid parameter value: parameter action should be \\\"delete\\\""
}
  Código de estado: 401
Unauthorized
{
  "error_code" : "APIG.1002",
  "error_msg" : "Incorrect token or token resolution failed"
}
  Código de estado: 403
Forbidden
{
  "error_code" : "APIG.1005",
  "error_msg" : "No permissions to request this method"
}
  Código de estado: 404
Not Found
{
  "error_code" : "APIG.3030",
  "error_msg" : "The instance does not exist;id:eddc4d25480b4cd6b512f270a1b8b341"
}
  Código de estado: 500
Internal Server Error
{
  "error_code" : "APIG.9999",
  "error_msg" : "System error"
}
 Códigos de estado
| 
        Código de estado  | 
      
        Descripción  | 
     
|---|---|
| 
        200  | 
      
        OK  | 
     
| 
        400  | 
      
        Bad Request  | 
     
| 
        401  | 
      
        Unauthorized  | 
     
| 
        403  | 
      
        Forbidden  | 
     
| 
        404  | 
      
        Not Found  | 
     
| 
        500  | 
      
        Internal Server Error  | 
     
Códigos de error
Consulte Códigos de error.