Merge pull request #155 from stackql/dev

New `google` provider

providers/src/googleapis.com/v00.00.00000/services/advisorynotifications.yaml

@@ -0,0 +1,382 @@
+openapi: 3.1.0
+info:
+  contact:
+    name: StackQL Studios
+    url: 'https://github.com/stackql/google-discovery-to-openapi'
+    email: [email protected]
+  title: Advisory Notifications API
+  description: An API for accessing Advisory Notifications in Google Cloud
+  version: v1
+  x-discovery-doc-revision: '20230729'
+  x-generated-date: '2023-08-01'
+externalDocs:
+  url: 'https://cloud.google.com/advisory-notifications'
+servers:
+  - url: 'https://advisorynotifications.googleapis.com'
+components:
+  securitySchemes:
+    Oauth2:
+      type: oauth2
+      description: Oauth 2.0 implicit authentication
+      flows:
+        implicit:
+          authorizationUrl: 'https://accounts.google.com/o/oauth2/auth'
+          scopes: &ref_0
+            'https://www.googleapis.com/auth/cloud-platform': 'See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.'
+    Oauth2c:
+      type: oauth2
+      description: Oauth 2.0 authorization code authentication
+      flows:
+        authorizationCode:
+          authorizationUrl: 'https://accounts.google.com/o/oauth2/auth'
+          tokenUrl: 'https://accounts.google.com/o/oauth2/token'
+          scopes: *ref_0
+  schemas:
+    GoogleCloudAdvisorynotificationsV1Csv:
+      id: GoogleCloudAdvisorynotificationsV1Csv
+      description: 'A representation of a CSV file attachment, as a list of column headers and a list of data rows.'
+      type: object
+      properties:
+        headers:
+          type: array
+          description: The list of headers for data columns in a CSV file.
+          items:
+            type: string
+        dataRows:
+          type: array
+          description: 'The list of data rows in a CSV file, as string arrays rather than as a single comma-separated string.'
+          items:
+            $ref: '#/components/schemas/GoogleCloudAdvisorynotificationsV1CsvCsvRow'
+    GoogleCloudAdvisorynotificationsV1Text:
+      description: A text object containing the English text and its localized copies.
+      type: object
+      id: GoogleCloudAdvisorynotificationsV1Text
+      properties:
+        enText:
+          type: string
+          description: The English copy.
+        localizedText:
+          type: string
+          description: The requested localized copy (if applicable).
+        localizationState:
+          enum:
+            - LOCALIZATION_STATE_UNSPECIFIED
+            - LOCALIZATION_STATE_NOT_APPLICABLE
+            - LOCALIZATION_STATE_PENDING
+            - LOCALIZATION_STATE_COMPLETED
+          enumDescriptions:
+            - Not used.
+            - 'Localization is not applicable for requested language. This can happen when: - The requested language was not supported by Advisory Notifications at the time of localization (including notifications created before the localization feature was launched). - The requested language is English, so only the English text is returned.'
+            - 'Localization for requested language is in progress, and not ready yet.'
+            - Localization for requested language is completed.
+          description: Status of the localization.
+          type: string
+    GoogleCloudAdvisorynotificationsV1Attachment:
+      id: GoogleCloudAdvisorynotificationsV1Attachment
+      type: object
+      description: Attachment with specific information about the issue.
+      properties:
+        csv:
+          $ref: '#/components/schemas/GoogleCloudAdvisorynotificationsV1Csv'
+          description: A CSV file attachment. Max size is 10 MB.
+        displayName:
+          type: string
+          description: The title of the attachment.
+    GoogleCloudAdvisorynotificationsV1Message:
+      properties:
+        body:
+          $ref: '#/components/schemas/GoogleCloudAdvisorynotificationsV1MessageBody'
+          description: The message content.
+        localizationTime:
+          format: google-datetime
+          description: Time when Message was localized
+          type: string
+        createTime:
+          type: string
+          format: google-datetime
+          description: The Message creation timestamp.
+        attachments:
+          items:
+            $ref: '#/components/schemas/GoogleCloudAdvisorynotificationsV1Attachment'
+          type: array
+          description: The attachments to download.
+      type: object
+      id: GoogleCloudAdvisorynotificationsV1Message
+      description: A message which contains notification details.
+    GoogleCloudAdvisorynotificationsV1ListNotificationsResponse:
+      properties:
+        nextPageToken:
+          type: string
+          description: 'A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.'
+        notifications:
+          items:
+            $ref: '#/components/schemas/GoogleCloudAdvisorynotificationsV1Notification'
+          description: List of notifications under a given parent.
+          type: array
+        totalSize:
+          description: Estimation of a total number of notifications.
+          format: int32
+          type: integer
+      type: object
+      description: Response of ListNotifications endpoint.
+      id: GoogleCloudAdvisorynotificationsV1ListNotificationsResponse
+    GoogleCloudAdvisorynotificationsV1CsvCsvRow:
+      type: object
+      description: A representation of a single data row in a CSV file.
+      id: GoogleCloudAdvisorynotificationsV1CsvCsvRow
+      properties:
+        entries:
+          description: 'The data entries in a CSV file row, as a string array rather than a single comma-separated string.'
+          type: array
+          items:
+            type: string
+    GoogleCloudAdvisorynotificationsV1MessageBody:
+      id: GoogleCloudAdvisorynotificationsV1MessageBody
+      type: object
+      properties:
+        text:
+          $ref: '#/components/schemas/GoogleCloudAdvisorynotificationsV1Text'
+          description: The text content of the message body.
+      description: A message body containing text.
+    GoogleCloudAdvisorynotificationsV1Subject:
+      properties:
+        text:
+          description: The text content.
+          $ref: '#/components/schemas/GoogleCloudAdvisorynotificationsV1Text'
+      type: object
+      description: A subject line of a notification.
+      id: GoogleCloudAdvisorynotificationsV1Subject
+    GoogleCloudAdvisorynotificationsV1Notification:
+      description: A notification object for notifying customers about security and privacy issues.
+      properties:
+        createTime:
+          description: Output only. Time the notification was created.
+          readOnly: true
+          type: string
+          format: google-datetime
+        notificationType:
+          description: Type of notification
+          enumDescriptions:
+            - Default type
+            - Security and privacy advisory notifications
+            - Sensitive action notifications
+            - General security MSA
+            - Threat horizons MSA
+          enum:
+            - NOTIFICATION_TYPE_UNSPECIFIED
+            - NOTIFICATION_TYPE_SECURITY_PRIVACY_ADVISORY
+            - NOTIFICATION_TYPE_SENSITIVE_ACTIONS
+            - NOTIFICATION_TYPE_SECURITY_MSA
+            - NOTIFICATION_TYPE_THREAT_HORIZONS
+          type: string
+        messages:
+          description: A list of messages in the notification.
+          items:
+            $ref: '#/components/schemas/GoogleCloudAdvisorynotificationsV1Message'
+          type: array
+        subject:
+          description: The subject line of the notification.
+          $ref: '#/components/schemas/GoogleCloudAdvisorynotificationsV1Subject'
+        name:
+          type: string
+          description: 'The resource name of the notification. Format: organizations/{organization}/locations/{location}/notifications/{notification}.'
+      type: object
+      id: GoogleCloudAdvisorynotificationsV1Notification
+  parameters:
+    quotaUser:
+      description: 'Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.'
+      in: query
+      name: quotaUser
+      schema:
+        type: string
+    access_token:
+      description: OAuth access token.
+      in: query
+      name: access_token
+      schema:
+        type: string
+    oauth_token:
+      description: OAuth 2.0 token for the current user.
+      in: query
+      name: oauth_token
+      schema:
+        type: string
+    key:
+      description: 'API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.'
+      in: query
+      name: key
+      schema:
+        type: string
+    uploadType:
+      description: 'Legacy upload protocol for media (e.g. "media", "multipart").'
+      in: query
+      name: uploadType
+      schema:
+        type: string
+    alt:
+      description: Data format for response.
+      in: query
+      name: alt
+      schema:
+        type: string
+        enum:
+          - json
+          - media
+          - proto
+    callback:
+      description: JSONP
+      in: query
+      name: callback
+      schema:
+        type: string
+    upload_protocol:
+      description: 'Upload protocol for media (e.g. "raw", "multipart").'
+      in: query
+      name: upload_protocol
+      schema:
+        type: string
+    _.xgafv:
+      description: V1 error format.
+      in: query
+      name: _.xgafv
+      schema:
+        type: string
+        enum:
+          - '1'
+          - '2'
+    prettyPrint:
+      description: Returns response with indentations and line breaks.
+      in: query
+      name: prettyPrint
+      schema:
+        type: boolean
+    fields:
+      description: Selector specifying which fields to include in a partial response.
+      in: query
+      name: fields
+      schema:
+        type: string
+  x-stackQL-resources:
+    notifications:
+      id: google.advisorynotifications.notifications
+      name: notifications
+      title: Notifications
+      methods:
+        get:
+          operation:
+            $ref: '#/paths/~1v1~1organizations~1{organizationsId}~1locations~1{locationsId}~1notifications~1{notificationsId}/get'
+          response:
+            mediaType: application/json
+            openAPIDocKey: '200'
+        list:
+          operation:
+            $ref: '#/paths/~1v1~1organizations~1{organizationsId}~1locations~1{locationsId}~1notifications/get'
+          response:
+            mediaType: application/json
+            openAPIDocKey: '200'
+      sqlVerbs:
+        select:
+          - $ref: '#/components/x-stackQL-resources/notifications/methods/get'
+          - $ref: '#/components/x-stackQL-resources/notifications/methods/list'
+        insert: []
+        update: []
+        delete: []
+paths:
+  '/v1/organizations/{organizationsId}/locations/{locationsId}/notifications/{notificationsId}':
+    parameters: &ref_1
+      - $ref: '#/components/parameters/quotaUser'
+      - $ref: '#/components/parameters/access_token'
+      - $ref: '#/components/parameters/oauth_token'
+      - $ref: '#/components/parameters/key'
+      - $ref: '#/components/parameters/uploadType'
+      - $ref: '#/components/parameters/alt'
+      - $ref: '#/components/parameters/callback'
+      - $ref: '#/components/parameters/upload_protocol'
+      - $ref: '#/components/parameters/_.xgafv'
+      - $ref: '#/components/parameters/prettyPrint'
+      - $ref: '#/components/parameters/fields'
+    get:
+      description: Gets a notification.
+      operationId: advisorynotifications.organizations.locations.notifications.get
+      security:
+        - Oauth2:
+            - 'https://www.googleapis.com/auth/cloud-platform'
+          Oauth2c:
+            - 'https://www.googleapis.com/auth/cloud-platform'
+      responses:
+        '200':
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GoogleCloudAdvisorynotificationsV1Notification'
+      parameters:
+        - in: path
+          name: organizationsId
+          required: true
+          schema:
+            type: string
+        - in: path
+          name: locationsId
+          required: true
+          schema:
+            type: string
+        - in: path
+          name: notificationsId
+          required: true
+          schema:
+            type: string
+        - in: query
+          name: languageCode
+          schema:
+            type: string
+      x-stackQL-resource: notifications
+      x-stackQL-method: get
+      x-stackQL-verb: select
+  '/v1/organizations/{organizationsId}/locations/{locationsId}/notifications':
+    parameters: *ref_1
+    get:
+      description: Lists notifications under a given parent.
+      operationId: advisorynotifications.organizations.locations.notifications.list
+      security:
+        - Oauth2:
+            - 'https://www.googleapis.com/auth/cloud-platform'
+          Oauth2c:
+            - 'https://www.googleapis.com/auth/cloud-platform'
+      responses:
+        '200':
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GoogleCloudAdvisorynotificationsV1ListNotificationsResponse'
+      parameters:
+        - in: path
+          name: organizationsId
+          required: true
+          schema:
+            type: string
+        - in: path
+          name: locationsId
+          required: true
+          schema:
+            type: string
+        - in: query
+          name: view
+          schema:
+            type: string
+        - in: query
+          name: pageSize
+          schema:
+            type: integer
+        - in: query
+          name: languageCode
+          schema:
+            type: string
+        - in: query
+          name: pageToken
+          schema:
+            type: string
+      x-stackQL-resource: notifications
+      x-stackQL-method: list
+      x-stackQL-verb: select