diff --git a/sdk/support/azure-mgmt-support/CHANGELOG.md b/sdk/support/azure-mgmt-support/CHANGELOG.md index 22f9c9cb7236f..608aa13f71af8 100644 --- a/sdk/support/azure-mgmt-support/CHANGELOG.md +++ b/sdk/support/azure-mgmt-support/CHANGELOG.md @@ -1,5 +1,17 @@ # Release History +## 1.0.0 (2020-03-14) + +**Features** + +- Model UpdateSupportTicket has a new parameter status +- Model Service has a new parameter resource_types + +**Breaking changes** + +- Model SupportTicketDetails no longer has parameter production_outage +- Operation SupportTicketsOperations.update has a new signature + ## 0.1.0 (2020-01-31) -* Initial Release \ No newline at end of file +* Initial Release diff --git a/sdk/support/azure-mgmt-support/README.md b/sdk/support/azure-mgmt-support/README.md index 59242422e139d..fd5542bc09d54 100644 --- a/sdk/support/azure-mgmt-support/README.md +++ b/sdk/support/azure-mgmt-support/README.md @@ -1,29 +1,21 @@ -## Microsoft Azure SDK for Python +# Microsoft Azure SDK for Python This is the Microsoft Azure Support Management Client Library. - -Azure Resource Manager (ARM) is the next generation of management APIs -that replace the old Azure Service Management (ASM). - This package has been tested with Python 2.7, 3.5, 3.6, 3.7 and 3.8. +For a more complete view of Azure libraries, see the [Github repo](https://github.com/Azure/azure-sdk-for-python/) -For the older Azure Service Management (ASM) libraries, see -[azure-servicemanagement-legacy](https://pypi.python.org/pypi/azure-servicemanagement-legacy) -library. -For a more complete set of Azure libraries, see the -[azure](https://pypi.python.org/pypi/azure) bundle package. +# Usage -## Usage +For code examples, see [Support Management](https://docs.microsoft.com/python/api/overview/azure/) +on docs.microsoft.com. -For code examples, see [Support -Management](https://docs.microsoft.com/python/api/overview/azure/) on -docs.microsoft.com. -## Provide Feedback +# Provide Feedback -If you encounter any bugs or have suggestions, please file an issue in -the [Issues](https://github.com/Azure/azure-sdk-for-python/issues) +If you encounter any bugs or have suggestions, please file an issue in the +[Issues](https://github.com/Azure/azure-sdk-for-python/issues) section of the project. -![image](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-python%2Fazure-mgmt-support%2FREADME.png) + +![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-python%2Fazure-mgmt-support%2FREADME.png) diff --git a/sdk/support/azure-mgmt-support/azure/mgmt/support/_microsoft_support.py b/sdk/support/azure-mgmt-support/azure/mgmt/support/_microsoft_support.py index b5cde2a156a0c..0078a66cd9d10 100644 --- a/sdk/support/azure-mgmt-support/azure/mgmt/support/_microsoft_support.py +++ b/sdk/support/azure-mgmt-support/azure/mgmt/support/_microsoft_support.py @@ -53,7 +53,7 @@ def __init__( super(MicrosoftSupport, self).__init__(self.config.credentials, self.config) client_models = {k: v for k, v in models.__dict__.items() if isinstance(v, type)} - self.api_version = '2019-05-01-preview' + self.api_version = '2020-04-01' self._serialize = Serializer(client_models) self._deserialize = Deserializer(client_models) diff --git a/sdk/support/azure-mgmt-support/azure/mgmt/support/models/__init__.py b/sdk/support/azure-mgmt-support/azure/mgmt/support/models/__init__.py index d34acc63b6f42..6da20f4af9c6b 100644 --- a/sdk/support/azure-mgmt-support/azure/mgmt/support/models/__init__.py +++ b/sdk/support/azure-mgmt-support/azure/mgmt/support/models/__init__.py @@ -60,6 +60,7 @@ PreferredContactMethod, CommunicationType, CommunicationDirection, + Status, ) __all__ = [ @@ -92,4 +93,5 @@ 'PreferredContactMethod', 'CommunicationType', 'CommunicationDirection', + 'Status', ] diff --git a/sdk/support/azure-mgmt-support/azure/mgmt/support/models/_microsoft_support_enums.py b/sdk/support/azure-mgmt-support/azure/mgmt/support/models/_microsoft_support_enums.py index 45a9d90ddaadd..e0ae55992052e 100644 --- a/sdk/support/azure-mgmt-support/azure/mgmt/support/models/_microsoft_support_enums.py +++ b/sdk/support/azure-mgmt-support/azure/mgmt/support/models/_microsoft_support_enums.py @@ -23,6 +23,7 @@ class SeverityLevel(str, Enum): minimal = "minimal" moderate = "moderate" critical = "critical" + highestcriticalimpact = "highestcriticalimpact" class PreferredContactMethod(str, Enum): @@ -41,3 +42,9 @@ class CommunicationDirection(str, Enum): inbound = "inbound" outbound = "outbound" + + +class Status(str, Enum): + + open = "open" + closed = "closed" diff --git a/sdk/support/azure-mgmt-support/azure/mgmt/support/models/_models.py b/sdk/support/azure-mgmt-support/azure/mgmt/support/models/_models.py index 0e76a7be125bf..1d0ae958c5db1 100644 --- a/sdk/support/azure-mgmt-support/azure/mgmt/support/models/_models.py +++ b/sdk/support/azure-mgmt-support/azure/mgmt/support/models/_models.py @@ -105,7 +105,8 @@ class CommunicationDetails(Model): include: 'inbound', 'outbound' :vartype communication_direction: str or ~azure.mgmt.support.models.CommunicationDirection - :param sender: Email address of the sender + :param sender: Email address of the sender. This property is required if + called by a service principal :type sender: str :param subject: Required. Subject of the communication :type subject: str @@ -174,22 +175,21 @@ class ContactProfile(Model): method is phone. :type phone_number: str :param preferred_time_zone: Required. Time zone of the user. This is the - name of the time zone from Microsoft - Time Zone Index Values. + name of the time zone from [Microsoft Time Zone Index + Values](https://support.microsoft.com/help/973627/microsoft-time-zone-index-values). :type preferred_time_zone: str :param country: Required. Country of the user. This is the ISO 3166-1 alpha-3 code. :type country: str :param preferred_support_language: Required. Preferred language of support from Azure. Support languages vary based on the severity you choose for - your support ticket. Learn more at Azure Severity - and responsiveness. Use the standard language-country code. Valid - values are 'en-us' for English, 'zh-hans' for Chinese, 'es-es' for - Spanish, 'fr-fr' for French, 'ja-jp' for Japanese, 'ko-kr' for Korean, - 'ru-ru' for Russian, 'pt-br' for Portuguese, 'it-it' for Italian, 'zh-tw' - for Chinese and 'de-de' for German. + your support ticket. Learn more at [Azure Severity and + responsiveness](https://azure.microsoft.com/support/plans/response). Use + the standard language-country code. Valid values are 'en-us' for English, + 'zh-hans' for Chinese, 'es-es' for Spanish, 'fr-fr' for French, 'ja-jp' + for Japanese, 'ko-kr' for Korean, 'ru-ru' for Russian, 'pt-br' for + Portuguese, 'it-it' for Italian, 'zh-tw' for Chinese and 'de-de' for + German. :type preferred_support_language: str """ @@ -382,9 +382,8 @@ def __init__(self, **kwargs): class QuotaTicketDetails(Model): """Additional set of information required for quota increase support ticket for certain quota types, e.g.: Virtual machine cores. Get complete details - about Quota payload support request along with examples at Support quota - request. + about Quota payload support request along with examples at [Support quota + request](https://aka.ms/supportrpquotarequestpayload). :param quota_change_request_sub_type: Required for certain quota types when there is a sub type that you are requesting quota increase for. @@ -425,6 +424,8 @@ class Service(Model): :vartype type: str :param display_name: Localized name of Azure service :type display_name: str + :param resource_types: ARM Resource types + :type resource_types: list[str] """ _validation = { @@ -438,6 +439,7 @@ class Service(Model): 'name': {'key': 'name', 'type': 'str'}, 'type': {'key': 'type', 'type': 'str'}, 'display_name': {'key': 'properties.displayName', 'type': 'str'}, + 'resource_types': {'key': 'properties.resourceTypes', 'type': '[str]'}, } def __init__(self, **kwargs): @@ -446,6 +448,7 @@ def __init__(self, **kwargs): self.name = None self.type = None self.display_name = kwargs.get('display_name', None) + self.resource_types = kwargs.get('resource_types', None) class ServiceError(Model): @@ -604,13 +607,13 @@ class SupportTicketDetails(Model): :vartype problem_classification_display_name: str :param severity: Required. A value that indicates the urgency of the case, which in turn determines the response time according to the service level - agreement of the technical support plan you have with Azure. Possible - values include: 'minimal', 'moderate', 'critical' + agreement of the technical support plan you have with Azure. Note: + 'Highest critical impact' severity is reserved only to our Premium + customers. Possible values include: 'minimal', 'moderate', 'critical', + 'highestcriticalimpact' :type severity: str or ~azure.mgmt.support.models.SeverityLevel :ivar enrollment_id: Enrollment ID associated with the support ticket. :vartype enrollment_id: str - :ivar production_outage: Indicates if this issue is a production outage. - :vartype production_outage: bool :param require24_x7_response: Indicates if this requires a 24x7 response from Azure. :type require24_x7_response: bool @@ -663,7 +666,6 @@ class SupportTicketDetails(Model): 'problem_classification_display_name': {'readonly': True}, 'severity': {'required': True}, 'enrollment_id': {'readonly': True}, - 'production_outage': {'readonly': True}, 'contact_details': {'required': True}, 'support_plan_type': {'readonly': True}, 'title': {'required': True}, @@ -684,7 +686,6 @@ class SupportTicketDetails(Model): 'problem_classification_display_name': {'key': 'properties.problemClassificationDisplayName', 'type': 'str'}, 'severity': {'key': 'properties.severity', 'type': 'str'}, 'enrollment_id': {'key': 'properties.enrollmentId', 'type': 'str'}, - 'production_outage': {'key': 'properties.productionOutage', 'type': 'bool'}, 'require24_x7_response': {'key': 'properties.require24X7Response', 'type': 'bool'}, 'contact_details': {'key': 'properties.contactDetails', 'type': 'ContactProfile'}, 'service_level_agreement': {'key': 'properties.serviceLevelAgreement', 'type': 'ServiceLevelAgreement'}, @@ -712,7 +713,6 @@ def __init__(self, **kwargs): self.problem_classification_display_name = None self.severity = kwargs.get('severity', None) self.enrollment_id = None - self.production_outage = None self.require24_x7_response = kwargs.get('require24_x7_response', None) self.contact_details = kwargs.get('contact_details', None) self.service_level_agreement = kwargs.get('service_level_agreement', None) @@ -767,21 +767,20 @@ class UpdateContactProfile(Model): method is phone. :type phone_number: str :param preferred_time_zone: Time zone of the user. This is the name of the - time zone from Microsoft - Time Zone Index Values. + time zone from [Microsoft Time Zone Index + Values](https://support.microsoft.com/en-us/help/973627/microsoft-time-zone-index-values). :type preferred_time_zone: str :param country: Country of the user. This is the ISO 3166-1 alpha-3 code. :type country: str :param preferred_support_language: Preferred language of support from Azure. Support languages vary based on the severity you choose for your - support ticket. Learn more at Azure Severity - and responsiveness. Use the standard language-country code. Valid - values are 'en-us' for English, 'zh-hans' for Chinese, 'es-es' for - Spanish, 'fr-fr' for French, 'ja-jp' for Japanese, 'ko-kr' for Korean, - 'ru-ru' for Russian, 'pt-br' for Portuguese, 'it-it' for Italian, 'zh-tw' - for Chinese and 'de-de' for German. + support ticket. Learn more at [Azure Severity and + responsiveness](https://azure.microsoft.com/support/plans/response/). Use + the standard language-country code. Valid values are 'en-us' for English, + 'zh-hans' for Chinese, 'es-es' for Spanish, 'fr-fr' for French, 'ja-jp' + for Japanese, 'ko-kr' for Korean, 'ru-ru' for Russian, 'pt-br' for + Portuguese, 'it-it' for Italian, 'zh-tw' for Chinese and 'de-de' for + German. :type preferred_support_language: str """ @@ -811,11 +810,14 @@ def __init__(self, **kwargs): class UpdateSupportTicket(Model): - """Updates severity and contact details in the support ticket. + """Updates severity, ticket status and contact details in the support ticket. :param severity: Severity level. Possible values include: 'minimal', - 'moderate', 'critical' + 'moderate', 'critical', 'highestcriticalimpact' :type severity: str or ~azure.mgmt.support.models.SeverityLevel + :param status: Status to be updated on the ticket. Possible values + include: 'open', 'closed' + :type status: str or ~azure.mgmt.support.models.Status :param contact_details: Contact details to be updated on the support ticket. :type contact_details: ~azure.mgmt.support.models.UpdateContactProfile @@ -823,10 +825,12 @@ class UpdateSupportTicket(Model): _attribute_map = { 'severity': {'key': 'severity', 'type': 'str'}, + 'status': {'key': 'status', 'type': 'str'}, 'contact_details': {'key': 'contactDetails', 'type': 'UpdateContactProfile'}, } def __init__(self, **kwargs): super(UpdateSupportTicket, self).__init__(**kwargs) self.severity = kwargs.get('severity', None) + self.status = kwargs.get('status', None) self.contact_details = kwargs.get('contact_details', None) diff --git a/sdk/support/azure-mgmt-support/azure/mgmt/support/models/_models_py3.py b/sdk/support/azure-mgmt-support/azure/mgmt/support/models/_models_py3.py index 96161258ac694..48c8be873275a 100644 --- a/sdk/support/azure-mgmt-support/azure/mgmt/support/models/_models_py3.py +++ b/sdk/support/azure-mgmt-support/azure/mgmt/support/models/_models_py3.py @@ -105,7 +105,8 @@ class CommunicationDetails(Model): include: 'inbound', 'outbound' :vartype communication_direction: str or ~azure.mgmt.support.models.CommunicationDirection - :param sender: Email address of the sender + :param sender: Email address of the sender. This property is required if + called by a service principal :type sender: str :param subject: Required. Subject of the communication :type subject: str @@ -174,22 +175,21 @@ class ContactProfile(Model): method is phone. :type phone_number: str :param preferred_time_zone: Required. Time zone of the user. This is the - name of the time zone from Microsoft - Time Zone Index Values. + name of the time zone from [Microsoft Time Zone Index + Values](https://support.microsoft.com/help/973627/microsoft-time-zone-index-values). :type preferred_time_zone: str :param country: Required. Country of the user. This is the ISO 3166-1 alpha-3 code. :type country: str :param preferred_support_language: Required. Preferred language of support from Azure. Support languages vary based on the severity you choose for - your support ticket. Learn more at Azure Severity - and responsiveness. Use the standard language-country code. Valid - values are 'en-us' for English, 'zh-hans' for Chinese, 'es-es' for - Spanish, 'fr-fr' for French, 'ja-jp' for Japanese, 'ko-kr' for Korean, - 'ru-ru' for Russian, 'pt-br' for Portuguese, 'it-it' for Italian, 'zh-tw' - for Chinese and 'de-de' for German. + your support ticket. Learn more at [Azure Severity and + responsiveness](https://azure.microsoft.com/support/plans/response). Use + the standard language-country code. Valid values are 'en-us' for English, + 'zh-hans' for Chinese, 'es-es' for Spanish, 'fr-fr' for French, 'ja-jp' + for Japanese, 'ko-kr' for Korean, 'ru-ru' for Russian, 'pt-br' for + Portuguese, 'it-it' for Italian, 'zh-tw' for Chinese and 'de-de' for + German. :type preferred_support_language: str """ @@ -382,9 +382,8 @@ def __init__(self, *, region: str=None, payload: str=None, **kwargs) -> None: class QuotaTicketDetails(Model): """Additional set of information required for quota increase support ticket for certain quota types, e.g.: Virtual machine cores. Get complete details - about Quota payload support request along with examples at Support quota - request. + about Quota payload support request along with examples at [Support quota + request](https://aka.ms/supportrpquotarequestpayload). :param quota_change_request_sub_type: Required for certain quota types when there is a sub type that you are requesting quota increase for. @@ -425,6 +424,8 @@ class Service(Model): :vartype type: str :param display_name: Localized name of Azure service :type display_name: str + :param resource_types: ARM Resource types + :type resource_types: list[str] """ _validation = { @@ -438,14 +439,16 @@ class Service(Model): 'name': {'key': 'name', 'type': 'str'}, 'type': {'key': 'type', 'type': 'str'}, 'display_name': {'key': 'properties.displayName', 'type': 'str'}, + 'resource_types': {'key': 'properties.resourceTypes', 'type': '[str]'}, } - def __init__(self, *, display_name: str=None, **kwargs) -> None: + def __init__(self, *, display_name: str=None, resource_types=None, **kwargs) -> None: super(Service, self).__init__(**kwargs) self.id = None self.name = None self.type = None self.display_name = display_name + self.resource_types = resource_types class ServiceError(Model): @@ -604,13 +607,13 @@ class SupportTicketDetails(Model): :vartype problem_classification_display_name: str :param severity: Required. A value that indicates the urgency of the case, which in turn determines the response time according to the service level - agreement of the technical support plan you have with Azure. Possible - values include: 'minimal', 'moderate', 'critical' + agreement of the technical support plan you have with Azure. Note: + 'Highest critical impact' severity is reserved only to our Premium + customers. Possible values include: 'minimal', 'moderate', 'critical', + 'highestcriticalimpact' :type severity: str or ~azure.mgmt.support.models.SeverityLevel :ivar enrollment_id: Enrollment ID associated with the support ticket. :vartype enrollment_id: str - :ivar production_outage: Indicates if this issue is a production outage. - :vartype production_outage: bool :param require24_x7_response: Indicates if this requires a 24x7 response from Azure. :type require24_x7_response: bool @@ -663,7 +666,6 @@ class SupportTicketDetails(Model): 'problem_classification_display_name': {'readonly': True}, 'severity': {'required': True}, 'enrollment_id': {'readonly': True}, - 'production_outage': {'readonly': True}, 'contact_details': {'required': True}, 'support_plan_type': {'readonly': True}, 'title': {'required': True}, @@ -684,7 +686,6 @@ class SupportTicketDetails(Model): 'problem_classification_display_name': {'key': 'properties.problemClassificationDisplayName', 'type': 'str'}, 'severity': {'key': 'properties.severity', 'type': 'str'}, 'enrollment_id': {'key': 'properties.enrollmentId', 'type': 'str'}, - 'production_outage': {'key': 'properties.productionOutage', 'type': 'bool'}, 'require24_x7_response': {'key': 'properties.require24X7Response', 'type': 'bool'}, 'contact_details': {'key': 'properties.contactDetails', 'type': 'ContactProfile'}, 'service_level_agreement': {'key': 'properties.serviceLevelAgreement', 'type': 'ServiceLevelAgreement'}, @@ -712,7 +713,6 @@ def __init__(self, *, description: str, problem_classification_id: str, severity self.problem_classification_display_name = None self.severity = severity self.enrollment_id = None - self.production_outage = None self.require24_x7_response = require24_x7_response self.contact_details = contact_details self.service_level_agreement = service_level_agreement @@ -767,21 +767,20 @@ class UpdateContactProfile(Model): method is phone. :type phone_number: str :param preferred_time_zone: Time zone of the user. This is the name of the - time zone from Microsoft - Time Zone Index Values. + time zone from [Microsoft Time Zone Index + Values](https://support.microsoft.com/en-us/help/973627/microsoft-time-zone-index-values). :type preferred_time_zone: str :param country: Country of the user. This is the ISO 3166-1 alpha-3 code. :type country: str :param preferred_support_language: Preferred language of support from Azure. Support languages vary based on the severity you choose for your - support ticket. Learn more at Azure Severity - and responsiveness. Use the standard language-country code. Valid - values are 'en-us' for English, 'zh-hans' for Chinese, 'es-es' for - Spanish, 'fr-fr' for French, 'ja-jp' for Japanese, 'ko-kr' for Korean, - 'ru-ru' for Russian, 'pt-br' for Portuguese, 'it-it' for Italian, 'zh-tw' - for Chinese and 'de-de' for German. + support ticket. Learn more at [Azure Severity and + responsiveness](https://azure.microsoft.com/support/plans/response/). Use + the standard language-country code. Valid values are 'en-us' for English, + 'zh-hans' for Chinese, 'es-es' for Spanish, 'fr-fr' for French, 'ja-jp' + for Japanese, 'ko-kr' for Korean, 'ru-ru' for Russian, 'pt-br' for + Portuguese, 'it-it' for Italian, 'zh-tw' for Chinese and 'de-de' for + German. :type preferred_support_language: str """ @@ -811,11 +810,14 @@ def __init__(self, *, first_name: str=None, last_name: str=None, preferred_conta class UpdateSupportTicket(Model): - """Updates severity and contact details in the support ticket. + """Updates severity, ticket status and contact details in the support ticket. :param severity: Severity level. Possible values include: 'minimal', - 'moderate', 'critical' + 'moderate', 'critical', 'highestcriticalimpact' :type severity: str or ~azure.mgmt.support.models.SeverityLevel + :param status: Status to be updated on the ticket. Possible values + include: 'open', 'closed' + :type status: str or ~azure.mgmt.support.models.Status :param contact_details: Contact details to be updated on the support ticket. :type contact_details: ~azure.mgmt.support.models.UpdateContactProfile @@ -823,10 +825,12 @@ class UpdateSupportTicket(Model): _attribute_map = { 'severity': {'key': 'severity', 'type': 'str'}, + 'status': {'key': 'status', 'type': 'str'}, 'contact_details': {'key': 'contactDetails', 'type': 'UpdateContactProfile'}, } - def __init__(self, *, severity=None, contact_details=None, **kwargs) -> None: + def __init__(self, *, severity=None, status=None, contact_details=None, **kwargs) -> None: super(UpdateSupportTicket, self).__init__(**kwargs) self.severity = severity + self.status = status self.contact_details = contact_details diff --git a/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_communications_operations.py b/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_communications_operations.py index 8525a478ce391..81009aa7fc044 100644 --- a/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_communications_operations.py +++ b/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_communications_operations.py @@ -26,7 +26,7 @@ class CommunicationsOperations(object): :param config: Configuration of service client. :param serializer: An object model serializer. :param deserializer: An object model deserializer. - :ivar api_version: Api version. Constant value: "2019-05-01-preview". + :ivar api_version: Api version. Constant value: "2020-04-01". """ models = models @@ -36,7 +36,7 @@ def __init__(self, client, config, serializer, deserializer): self._client = client self._serialize = serializer self._deserialize = deserializer - self.api_version = "2019-05-01-preview" + self.api_version = "2020-04-01" self.config = config @@ -114,13 +114,12 @@ def list( self, support_ticket_name, top=None, filter=None, custom_headers=None, raw=False, **operation_config): """Lists all communications (attachments not included) for a support ticket.

You can also filter support ticket communications by - CreatedDate�or CommunicationType using the $filter - parameter. The only type of communication supported today is - Web. Output will be a paged result with nextLink, using - which you can retrieve the next set of Communication results. -

Support ticket data is available for 12 months after ticket - creation. If a ticket was created more than 12 months ago, a request - for data might cause an error. + _CreatedDate_ or _CommunicationType_ using the $filter parameter. The + only type of communication supported today is _Web_. Output will be a + paged result with _nextLink_, using which you can retrieve the next set + of Communication results.

Support ticket data is available + for 12 months after ticket creation. If a ticket was created more than + 12 months ago, a request for data might cause an error. :param support_ticket_name: Support ticket name :type support_ticket_name: str @@ -202,7 +201,7 @@ def internal_paging(next_link=None): def get( self, support_ticket_name, communication_name, custom_headers=None, raw=False, **operation_config): - """Returns details of a specific communication in a support ticket. + """Returns communication details for a support ticket. :param support_ticket_name: Support ticket name :type support_ticket_name: str @@ -310,12 +309,7 @@ def _create_initial( def create( self, support_ticket_name, communication_name, create_communication_parameters, custom_headers=None, raw=False, polling=True, **operation_config): - """Adds a new customer communication to an Azure support ticket. Adding - attachments are not currently supported via the API.
To add a file - to a support ticket, visit the Manage - support ticket page in the Azure portal, select the support ticket, - and use the file upload control to add a new file. + """Adds a new customer communication to an Azure support ticket. :param support_ticket_name: Support ticket name :type support_ticket_name: str diff --git a/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_operations.py b/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_operations.py index 7dd29f0ddd3b6..f41866826e837 100644 --- a/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_operations.py +++ b/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_operations.py @@ -24,7 +24,7 @@ class Operations(object): :param config: Configuration of service client. :param serializer: An object model serializer. :param deserializer: An object model deserializer. - :ivar api_version: Api version. Constant value: "2019-05-01-preview". + :ivar api_version: Api version. Constant value: "2020-04-01". """ models = models @@ -34,7 +34,7 @@ def __init__(self, client, config, serializer, deserializer): self._client = client self._serialize = serializer self._deserialize = deserializer - self.api_version = "2019-05-01-preview" + self.api_version = "2020-04-01" self.config = config diff --git a/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_problem_classifications_operations.py b/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_problem_classifications_operations.py index a4b59a959b7b4..0ec28bdd585c4 100644 --- a/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_problem_classifications_operations.py +++ b/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_problem_classifications_operations.py @@ -24,7 +24,7 @@ class ProblemClassificationsOperations(object): :param config: Configuration of service client. :param serializer: An object model serializer. :param deserializer: An object model deserializer. - :ivar api_version: Api version. Constant value: "2019-05-01-preview". + :ivar api_version: Api version. Constant value: "2020-04-01". """ models = models @@ -34,14 +34,14 @@ def __init__(self, client, config, serializer, deserializer): self._client = client self._serialize = serializer self._deserialize = deserializer - self.api_version = "2019-05-01-preview" + self.api_version = "2020-04-01" self.config = config def list( self, service_name, custom_headers=None, raw=False, **operation_config): """Lists all the problem classifications (categories) available for a - specific Azure service.

Always use the service and problem + specific Azure service. Always use the service and problem classifications obtained programmatically. This practice ensures that you always have the most recent set of service and problem classification Ids. @@ -112,8 +112,7 @@ def internal_paging(next_link=None): def get( self, service_name, problem_classification_name, custom_headers=None, raw=False, **operation_config): - """Gets the details of a specific problem classification for a specific - Azure service. + """Get problem classification details for a specific Azure service. :param service_name: Name of Azure service available for support. :type service_name: str diff --git a/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_services_operations.py b/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_services_operations.py index f83aa0c341f08..b1c59529cfb20 100644 --- a/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_services_operations.py +++ b/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_services_operations.py @@ -24,7 +24,7 @@ class ServicesOperations(object): :param config: Configuration of service client. :param serializer: An object model serializer. :param deserializer: An object model deserializer. - :ivar api_version: Api version. Constant value: "2019-05-01-preview". + :ivar api_version: Api version. Constant value: "2020-04-01". """ models = models @@ -34,26 +34,21 @@ def __init__(self, client, config, serializer, deserializer): self._client = client self._serialize = serializer self._deserialize = deserializer - self.api_version = "2019-05-01-preview" + self.api_version = "2020-04-01" self.config = config def list( self, custom_headers=None, raw=False, **operation_config): - """Lists all the Azure services available for support ticket creation. - Here are the Service Ids for **Billing**, **Subscription Management**, - and **Service and subscription limits (Quotas)** issues: -
Issue typeService - Id
Billing'/providers/Microsoft.Support/services/517f2da6-78fd-0498-4e22-ad26996b1dfc'
Subscription - Management'/providers/Microsoft.Support/services/f3dc5421-79ef-1efa-41a5-42bf3cbb52c6'
Quota'/providers/Microsoft.Support/services/06bfd9d3-516b-d5c6-5802-169c800dec89'
-

For **Technical** issues, select the Service Id that maps to - the Azure service/product as displayed in the **Services** drop-down - list on the Azure portal's New - support request page.

Always use the service and it's - corresponding problem classification(s) obtained programmatically for - support ticket creation. This practice ensures that you always have the - most recent set of service and problem classification Ids. + """Lists all the Azure services available for support ticket creation. For + **Technical** issues, select the Service Id that maps to the Azure + service/product as displayed in the **Services** drop-down list on the + Azure portal's [New support + request](https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview) + page. Always use the service and it's corresponding problem + classification(s) obtained programmatically for support ticket + creation. This practice ensures that you always have the most recent + set of service and problem classification Ids. :param dict custom_headers: headers that will be added to the request :param bool raw: returns the direct response alongside the diff --git a/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_support_tickets_operations.py b/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_support_tickets_operations.py index 12aee0fe8c043..1030c14835955 100644 --- a/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_support_tickets_operations.py +++ b/sdk/support/azure-mgmt-support/azure/mgmt/support/operations/_support_tickets_operations.py @@ -26,7 +26,7 @@ class SupportTicketsOperations(object): :param config: Configuration of service client. :param serializer: An object model serializer. :param deserializer: An object model deserializer. - :ivar api_version: Api version. Constant value: "2019-05-01-preview". + :ivar api_version: Api version. Constant value: "2020-04-01". """ models = models @@ -36,7 +36,7 @@ def __init__(self, client, config, serializer, deserializer): self._client = client self._serialize = serializer self._deserialize = deserializer - self.api_version = "2019-05-01-preview" + self.api_version = "2020-04-01" self.config = config @@ -109,24 +109,23 @@ def check_name_availability( def list( self, top=None, filter=None, custom_headers=None, raw=False, **operation_config): - """Lists all the support tickets for an Azure subscription.

You - can also filter the support tickets by Status or - CreatedDate using the $filter parameter. Output will be a paged - result with nextLink, using which you can retrieve the next set - of support tickets.

Support ticket data is available for 12 - months after ticket creation. If a ticket was created more than 12 - months ago, a request for data might cause an error. + """Lists all the support tickets for an Azure subscription. You can also + filter the support tickets by _Status_ or _CreatedDate_ using the + $filter parameter. Output will be a paged result with _nextLink_, using + which you can retrieve the next set of support tickets. +

Support ticket data is available for 12 months after ticket + creation. If a ticket was created more than 12 months ago, a request + for data might cause an error. :param top: The number of values to return in the collection. Default is 25 and max is 100. :type top: int :param filter: The filter to apply on the operation. We support 'odata - v4.0' filter semantics. Learn - more
Status filter can only be used with 'eq' - operator. For CreatedDate filter, the supported operators are - 'gt' and 'ge'. When using both filters, combine them using the logical - 'AND'. + v4.0' filter semantics. [Learn + more](https://docs.microsoft.com/odata/concepts/queryoptions-overview). + _Status_ filter can only be used with 'eq' operator. For _CreatedDate_ + filter, the supported operators are 'gt' and 'ge'. When using both + filters, combine them using the logical 'AND'. :type filter: str :param dict custom_headers: headers that will be added to the request :param bool raw: returns the direct response alongside the @@ -195,10 +194,9 @@ def internal_paging(next_link=None): def get( self, support_ticket_name, custom_headers=None, raw=False, **operation_config): - """Gets details for a specific support ticket in an Azure subscription. -

Support ticket data is available for 12 months after ticket - creation. If a ticket was created more than 12 months ago, a request - for data might cause an error. + """Get ticket details for an Azure subscription. Support ticket data is + available for 12 months after ticket creation. If a ticket was created + more than 12 months ago, a request for data might cause an error. :param support_ticket_name: Support ticket name :type support_ticket_name: str @@ -254,22 +252,22 @@ def get( get.metadata = {'url': '/subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}'} def update( - self, support_ticket_name, severity=None, contact_details=None, custom_headers=None, raw=False, **operation_config): - """This API allows you to update the severity level or your contact - information in the support ticket.

Note: The severity levels - cannot be changed if a support ticket is actively being worked upon by - an Azure support engineer. In such a case, contact your support - engineer to request severity update by adding a new communication using - the Communications API. + self, support_ticket_name, update_support_ticket, custom_headers=None, raw=False, **operation_config): + """This API allows you to update the severity level, ticket status, and + your contact information in the support ticket.

Note: The + severity levels cannot be changed if a support ticket is actively being + worked upon by an Azure support engineer. In such a case, contact your + support engineer to request severity update by adding a new + communication using the Communications API.

Changing the + ticket status to _closed_ is allowed only on an unassigned case. When + an engineer is actively working on the ticket, send your ticket closure + request by sending a note to your engineer. :param support_ticket_name: Support ticket name :type support_ticket_name: str - :param severity: Severity level. Possible values include: 'minimal', - 'moderate', 'critical' - :type severity: str or ~azure.mgmt.support.models.SeverityLevel - :param contact_details: Contact details to be updated on the support - ticket. - :type contact_details: ~azure.mgmt.support.models.UpdateContactProfile + :param update_support_ticket: UpdateSupportTicket object + :type update_support_ticket: + ~azure.mgmt.support.models.UpdateSupportTicket :param dict custom_headers: headers that will be added to the request :param bool raw: returns the direct response alongside the deserialized response @@ -281,8 +279,6 @@ def update( :raises: :class:`ExceptionResponseException` """ - update_support_ticket = models.UpdateSupportTicket(severity=severity, contact_details=contact_details) - # Construct URL url = self.update.metadata['url'] path_format_arguments = { @@ -376,18 +372,29 @@ def _create_initial( def create( self, support_ticket_name, create_support_ticket_parameters, custom_headers=None, raw=False, polling=True, **operation_config): - """Creates a new support ticket for Quota increase, Technical, Billing, - and Subscription Management issues for the specified subscription. -

A paid technical support plan is required to create a support - ticket using this API. Learn - more

Use the Services API to map the right Service Id to - the issue type. For example: For billing tickets set *serviceId* to - *'/providers/Microsoft.Support/services/517f2da6-78fd-0498-4e22-ad26996b1dfc'*. -
For Technical issues, the Service id will map to the Azure - service you want to raise a support ticket for.

Always call - the Services and ProblemClassifications API to get the most recent set - of services and problem categories required for support ticket - creation. + """Creates a new support ticket for Subscription and Service limits + (Quota), Technical, Billing, and Subscription Management issues for the + specified subscription. Learn the + [prerequisites](https://aka.ms/supportAPI) required to create a support + ticket.

Always call the Services and ProblemClassifications + API to get the most recent set of services and problem categories + required for support ticket creation.

Adding attachments are + not currently supported via the API. To add a file to an existing + support ticket, visit the [Manage support + ticket](https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/managesupportrequest) + page in the Azure portal, select the support ticket, and use the file + upload control to add a new file.

Providing consent to share + diagnostic information with Azure support is currently not supported + via the API. Azure support engineer, working on your ticket, will reach + out to you for consent if your issue requires gathering diagnostic + information from your Azure resources.

**Creating a support + ticket for on-behalf-of**: Include _x-ms-authorization-auxiliary_ + header to provide an auxiliary token as per + [this](https://docs.microsoft.com/azure/azure-resource-manager/management/authenticate-multi-tenant). + The primary token will be from the tenant for whom a support ticket is + being raised against the subscription, i.e. Cloud solution provider + (CSP) customer tenant. The auxiliary token will be from the Cloud + solution provider (CSP) partner tenant. :param support_ticket_name: Support ticket name. :type support_ticket_name: str diff --git a/sdk/support/azure-mgmt-support/azure/mgmt/support/version.py b/sdk/support/azure-mgmt-support/azure/mgmt/support/version.py index e0ec669828cbf..a39916c162cec 100644 --- a/sdk/support/azure-mgmt-support/azure/mgmt/support/version.py +++ b/sdk/support/azure-mgmt-support/azure/mgmt/support/version.py @@ -9,5 +9,5 @@ # regenerated. # -------------------------------------------------------------------------- -VERSION = "0.1.0" +VERSION = "1.0.0"