VPC-4475, VPC-4437: update two Partner Network Connect endpoints (#1038)

* POST to service_key returns an empty JSON object

* add redundancy_zone parameter

* fix schema error

Author: beardicus

specification/resources/partner_network_connect/models/partner_attachment.yml

@@ -160,6 +160,11 @@ partner_attachment_writable:
           type: string
           example: 0xsNnb1pwQlowdoMySEfWwk4I
           description: BGP Auth Key
+    redundancy_zone:
+      type: string
+      description: Optional redundancy zone for the partner attachment.
+      enum: [ UNSPECIFIED, MEGAPORT_BLUE, MEGAPORT_RED ]
+      example: MEGAPORT_BLUE
 
 partner_attachment_updatable:
   anyOf:

specification/resources/partner_network_connect/partner_attachment_service_key_create.yml

@@ -4,6 +4,8 @@ summary: Regenerate the service key for the partner attachment
 
 description: >
   This operation generates a new service key for the specified partner attachment.
+  The operation is asynchronous, and the response is an empty JSON object returned with a 202 status code.
+  To poll for the new service key, send a `GET` request to `/v2/partner_network_connect/attachments/{pa_id}/service_key`.
 
 tags:
   - Partner Network Connect
@@ -13,7 +15,7 @@ parameters:
 
 responses:
   '202':
-    $ref: 'responses/single_partner_attachment_service_key.yml'
+    $ref: 'responses/empty_json_object.yml'
 
   '401':
     $ref: '../../shared/responses/unauthorized.yml'

specification/resources/partner_network_connect/responses/empty_json_object.yml

@@ -0,0 +1,18 @@
+description:  |-
+  The response is an empty JSON object.
+
+headers:
+  ratelimit-limit:
+    $ref: '../../../shared/headers.yml#/ratelimit-limit'
+  ratelimit-remaining:
+    $ref: '../../../shared/headers.yml#/ratelimit-remaining'
+  ratelimit-reset:
+    $ref: '../../../shared/headers.yml#/ratelimit-reset'
+
+content:
+  application/json:
+    schema:
+      type: object
+      properties: {}
+    example: {}
+