All Products
Search

This Product

    Resource Management:AddMessageContact

    Document Center

    Resource Management:AddMessageContact

    Last Updated:Dec 18, 2023

    Adds a contact.

    Debugging

    OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

    Debug

    Authorization information

    There is currently no authorization information disclosed in the API.

    Request parameters

    ParameterTypeRequiredDescriptionExample
    NamestringYes

    The name of the contact.

    The name must be unique in your resource directory.

    The name must be 2 to 12 characters in length and can contain only letters.

    		tom
    EmailAddressstringYes

    The email address of the contact.

    After you specify an email address, you need to call SendEmailVerificationForMessageContact to send verification information to the email address. After the verification is passed, the email address takes effect.

    		someone***@example.com
    PhoneNumberstringNo

    The mobile phone number of the contact.

    Specify the mobile phone number in the <Country code>-<Mobile phone number> format.

    Note Only mobile phone numbers in the 86-<Mobile phone number> format in the Chinese mainland are supported.

    After you specify a mobile phone number, you need to call SendPhoneVerificationForMessageContact to send verification information to the mobile phone number. After the verification is passed, the mobile phone number takes effect.

    		86-139****1234
    TitlestringYes

    The job title of the contact.

    Valid values:

    • FinanceDirector

    • TechnicalDirector

    • MaintenanceDirector

    • CEO

    • ProjectDirector

    • Other

    		TechnicalDirector
    MessageTypesarrayYes

    The types of messages received by the contact.

    stringYes

    The type of the message received by the contact.

    Valid values:

    • ServiceMessage

    • FaultMessage

    • AccountExpenses

    • SecurityMessage

    • ActivityMessage

    • ProductMessage

    		AccountExpenses

    Response parameters

    ParameterTypeDescriptionExample
    object

    The returned result.

    RequestIdstring

    The request ID.

    		2DFCE4C9-04A9-4C83-BB14-FE791275EC53
    Contactobject

    The information about the contact.

    ContactIdstring

    The ID of the contact.

    		c-qL4HqKONzOM7****
    CreateDatestring

    The time when the contact was created.

    		2023-03-27 17:19:21

    Examples

    Sample success responses

    JSONformat

    {
  "RequestId": "2DFCE4C9-04A9-4C83-BB14-FE791275EC53",
  "Contact": {
    "ContactId": "c-qL4HqKONzOM7****",
    "CreateDate": "2023-03-27 17:19:21"
  }
}

    Error codes

    HTTP status codeError codeError messageDescription
    400MissingParameter.NameYou must specify Name.You must specify Name.
    400InvalidParameter.NameThe Name is invalid.The value of the Name parameter is invalid. The value can contain only letters.
    400InvalidParameter.Name.LengthThe Name exceeds the length limit.The length of the value specified for the Name parameter exceeds the upper limit. The value must be 2 to 12 characters in length and can contain only letters.
    400InvalidParameter.Name.AlreadyUsedThe Name already exists. Please change to another name.The contact name already exists in the resource directory. Use another name.
    400MissingParameter.EmailAddressYou must specify EmailAddress.The EmailAddress parameter is not configured.
    400InvalidParameter.EmailAddressThe EmailAddress is invalid.The value of the EmailAddress parameter is invalid.
    400MissingParameter.PhoneNumberYou must specify PhoneNumber.The PhoneNumber parameter is not configured.
    400InvalidParameter.PhoneNumberThe PhoneNumber is invalid.The value of the PhoneNumber parameter is invalid.
    400MissingParameter.TitleYou must specify Title.The Title parameter is not configured.
    400InvalidParameter.TitleThe Title is invalid.The value of the Title parameter is invalid.
    400MissingParameter.MessageTypesYou must specify MessageTypes.The MessageTypes parameter is not configured.
    400InvalidParameter.MessageTypesThe MessageTypes is invalid.The value of the MessageTypes parameter is invalid.
    400LimitExceeded.ContactsThe maximum number of contacts in a resource directory exceeds the limit.The number of contacts exceeds the upper limit.
    400InvalidParameter.MobileCountryCodeThe current site does not support the country code.The specified country code is not supported at the current site.
    400InvalidParameter.EmailAddress.LengthThe EmailAddress exceeds the length limit.The length of the value specified for the EmailAddress parameter exceeds the upper limit.
    429ConcurrentCallNotSupportedThe operation conflicts with other operations. Please try again later.The operation conflicts with other operations. Try again later.

    For a list of error codes, visit the Service error codes.

    Change history

    Change timeSummary of changesOperation
    2023-07-25The Error code has changedsee changesets
    Change itemChange content
    Error CodesThe Error code has changed.
      delete Error Codes: 400
      delete Error Codes: 429