DsgDesensPlanAddOrUpdate - - Centro de documentación de Alibaba Cloud

Agrega o modifique una regla de enmascaramiento de datos.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que ejecute esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DsgDesensPlanAddOrUpdate	La operación que desea ejecutar. Establezca el valor en DsgDesensPlanAddOrUpdate.
DesensRules	Array	Sí		Conjunto de reglas de enmascaramiento de datos que desea agregar o modifique.
Id	Integer	No	123	El ID de la regla de enmascaramiento de datos. Llame a la operación DsgDesensPlanQueryList para consultar el ID de la regla de enmascaramiento de datos.
DataType	String	Sí	phone	El tipo de campo sensible.
RuleName	String	Sí	phone_hash	El nombre de la regla de enmascaramiento de datos.
Status	Integer	No	1	El estado de la regla de enmascaramiento de datos. Valores válidos: 0: caducado 1: vigente
SceneIds	Array of Integer	Sí	123	El ID del escenario de enmascaramiento de datos de nivel 2. Asegúrese de que la regla de enmascaramiento de datos donde se especifica el tipo de campo sensible determinado por el parámetro DataType no esté configurada para el escenario de enmascaramiento de datos de nivel 2 que utiliza. Llame a la operación DsgSceneQuerySceneListByName para consultar el ID del escenario de enmascaramiento de datos.
Owner	String	Sí	test_user	El propietario de la regla de enmascaramiento de datos.
CheckWatermark	Boolean	No	true	Especifica si se debe agregar una marca de agua. Valores válidos: true false
DesensPlan	Object	Sí		La regla de enmascaramiento de datos.
DesensPlanType	String	Sí	hash	El método de enmascaramiento configurado en la regla de enmascaramiento de datos. Valores válidos: hash mapping mask charreplacement intervalselect decimalpoint emptydesens
ExtParam	Map	No	{ "algo": "MD5", "salt":6 }	Los parámetros de la regla de enmascaramiento de datos.
	Any	No	{ "algo": "MD5", "salt":6 }	Las configuraciones de parámetros de la regla de enmascaramiento de datos. Agregue diferentes parámetros según la regla de enmascaramiento de datos que desee configure. Para obtener más información, consulte el siguiente ejemplo.

El parámetro ExtParam es un parámetro dinámico. El valor del parámetro ExtParam varía según la regla de enmascaramiento de datos. El siguiente ejemplo muestra cómo configure los parámetros:

Hash:
{
    "algo": "MD5",
    "salt": 6
}
Pseudonym:
{
    "charset": "Aa",
    "salt": 6
}
Mask:
{
    "before": 3,
    "after": 4
}
Custom mask:
{
    "separatorList": [
        {
            "desens": true,
            "left": 3
        },
        {
            "desens": false,
            "left": 6
        },
        {
            "desens": true,
            "left": -99
        }
    ]
}
Sample value character replacement:
{
    "library": "test_library",
    "position": 3
}
Fixed value character replacement:
{
    "replace": "repData",
    "position": 3
}
Random character replacement:
{
    "replace": "repData"
}
Custom character replacement:
{
    "separatorList": [
        {
            "desensParam": {
                "replace": "repData"
            },
            "left": 3
        },
        {
            "desensParam": {
                "library": "test_library"
            },
            "left": 6
        },
        {
            "desensParam": {
            },
            "left": 99
        }
    ]
}
Range change:
{
    "intervalselects": [
        {
            "desens": "1",
            "interval": [
                "1",
                "100"
            ]
        }
    ]
}
Rounding:
{
"point":3
}
Leave empty:
{}

Llame a la operación DsgQueryDefaultTemplates para consultar los métodos de enmascaramiento de datos compatibles y las reglas relacionadas.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Success	Boolean	true	Indica si la solicitud fue exitosa. Valores válidos: true false
ErrorCode	String	1029030003	El código de error.
ErrorMessage	String	param error	El mensaje de error.
HttpStatusCode	Integer	400	El código de estado HTTP.
Data	Boolean	true	El resultado de ejecución al agregar o modifique una regla de enmascaramiento de datos.
RequestId	String	102400001	El ID de la solicitud. Use este ID para localizar registros y solucionar problemas.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=DsgDesensPlanAddOrUpdate
&DesensRules=[{"id":123,"DataType":"phone","RuleName":"phone_hash","Status":1,"SceneIds":[123],"Owner":"test_user","CheckWatermark":true,"DesensPlan":{"DesensPlanType":"hash","ExtParam":{"key":"{           \"algo\": \"MD5\", \"salt\":6         }"}}}]
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DsgDesensPlanAddOrUpdateResponse>
    <Success>true</Success>
    <ErrorCode>1029030003</ErrorCode>
    <ErrorMessage>param error</ErrorMessage>
    <HttpStatusCode>400</HttpStatusCode>
    <Data>true</Data>
    <RequestId>102400001</RequestId>
</DsgDesensPlanAddOrUpdateResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Success" : true,
  "ErrorCode" : "1029030003",
  "ErrorMessage" : "param error",
  "HttpStatusCode" : 400,
  "Data" : true,
  "RequestId" : "102400001"
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	PARAMS.ERROR	param error.	Los valores especificados para uno o más parámetros no son válidos.
400	DESENSPLAN.DATATYPE.ERROR	Sensitive type already has a desensitization rule.	El tipo de campo sensible ya se ha especificado en la regla de enmascaramiento de datos.
400	DESENSPLAN.DATATYPENOTEXIST.ERROR	Sensitive type not exist.	El tipo de campo sensible no existe.
400	DESENSPLAN.ID.ERROR	Desensitization rule ID does not exist.	El ID de la regla de enmascaramiento de datos no existe.
400	DESENSPLAN.PAGESIZE.ERROR	Page size is too large, maximum of 100.	El número de entradas por página supera el límite superior. El número máximo de entradas por página es 100.
400	DESENSPLAN.PARAM.ERROR	Desensitization rule parameter error.	Los valores especificados para uno o más parámetros de la regla de enmascaramiento de datos no son válidos.
400	DESENSPLAN.SCENECODE.ERROR	Scene code does not exist.	El código de escenario no existe.
400	DESENSPLAN.SCENEID.ERROR	Scene ID does not exist.	El ID de escenario no existe.
400	DESENSPLAN.SCENEIDLEVEL.ERROR	The scene is not a secondary scene.	El escenario de enmascaramiento de datos no es un escenario de enmascaramiento de datos de nivel 2.
400	DESENSPLAN.SIZE.ERROR	The number of desens plan exceeds the limit.	El número de reglas de enmascaramiento de datos supera el límite superior.
403	PERMISSION.DENIED.ERROR	Permission denied	No tiene autorización para realizar esta operación.
500	UNKNOWN.ERROR	unknown error.	Se ha producido un error desconocido.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.